🗑️ skills remove: Remoção Precisa
O comando skills remove remove skills instaladas. Sem argumentos, abre seleção interativa. Com nome, remove diretamente.
# Remoção interativa (selecionar da lista) npx skills remove # Remoção por nome npx skills remove react-best-practices # Múltiplas de uma vez npx skills remove react-best-practices nextjs-routing # Sem confirmação npx skills remove -y react-best-practices
💡 Dica de segurança
Sempre use skills list antes de remove. Confirme que você está removendo a skill certa do escopo certo. Symlinks são removidos (não deletados da fonte).
🔍 Remoção por Escopo
Uma skill pode existir tanto no escopo de projeto quanto no global. Use as flags -g e -p para remover do escopo correto.
Remover do projeto
npx skills remove -p react-best-practices
Remove de .claude/skills/, .cursor/rules/ etc.
Remover do global
npx skills remove -g react-best-practices
Remove de ~/.claude/skills/, ~/.cursor/rules/ etc.
Sem flag: CLI pergunta
Se a skill existir em ambos os escopos e você não especificar -g ou -p, o CLI pergunta interativamente de qual escopo você quer remover. Isso evita remoção acidental.
🌱 skills init: Criando seu Template
O comando npx skills init [name] cria um arquivo SKILL.md com o template padrão pré-preenchido, pronto para você personalizar.
# Criar template com nome específico npx skills init minha-primeira-skill # Resultado: Created: skills/minha-primeira-skill.md # Sem nome: usa "my-skill" como padrão npx skills init
O que o init cria
- •Arquivo em skills/[name].md
- •Frontmatter com name preenchido e description placeholder
- •Seções When to Use e Steps com exemplos
- •Cria a pasta skills/ se não existir
✏️ O Template Gerado pelo init
O template gerado segue a especificação oficial do agentskills.io. Cada seção tem comentários indicando o que deve ser preenchido.
--- name: minha-primeira-skill description: [Descreva o que essa skill faz e quando usar] --- # Minha Primeira Skill [Introdução breve: o que o agente deve saber sobre esta skill] ## When to Use - [Cenário 1 em que a skill deve ser ativada] - [Cenário 2: "quando o usuário pedir para..."] - [Cenário 3: "ao trabalhar com..."] ## Steps 1. [Primeiro passo do processo] 2. [Segundo passo] 3. [Continue conforme necessário]
💡 Foco no que importa
Comece pela description — ela é o campo mais crítico. Só passe para o corpo depois de ter uma description clara e precisa. Uma boa description vale mais que um corpo longo.
🧪 Testando sua Skill Localmente
Após criar a skill com init e editá-la, instale localmente para testar antes de publicar. O path local é o ciclo de desenvolvimento padrão.
Criar e editar
npx skills init minha-skill && code skills/minha-skill.md
Instalar localmente
npx skills add ./
Testar com o agente
Acione um cenário do "When to Use" e observe se o agente aplica a skill corretamente
Iterar e refinar
Edite o SKILL.md, remova e reinstale: npx skills remove minha-skill && npx skills add ./
🚀 Fluxo: init → editar → testar → publicar
O fluxo completo de criação e publicação de uma skill pública. Seguindo esses passos, sua skill pode aparecer no diretório skills.sh e beneficiar a comunidade.
# 1. Criar repositório e skill mkdir meu-repositorio-skills && cd meu-repositorio-skills npx skills init minha-skill # 2. Editar e testar localmente # [editar skills/minha-skill.md] npx skills add ./ # [testar com o agente...] # 3. Publicar no GitHub git init && git add . && git commit -m "feat: minha-skill" gh repo create meu-repositorio-skills --public git push # 4. Compartilhar # Qualquer um pode instalar com: npx skills add seu-usuario/meu-repositorio-skills
Aparecer no skills.sh
Skills públicas são indexadas automaticamente pelo skills.sh à medida que ganham instalações. Quanto mais o repositório for usado (npx skills add), mais alto ele aparece no leaderboard.
✅ Resumo do Módulo
Próxima Trilha:
Trilha 3 — ✍️ Criando Skills: Escreva SKILL.md eficazes, organize repositórios e use campos avançados