skill-writer
Criar Habilidades de Agente para Claude Code
Também disponível em: pytorch
Os usuários frequentemente têm dificuldade em criar Habilidades de Agente bem estruturadas que seguem as melhores práticas. Esta habilidade fornece orientação passo a passo para criar, validar e testar Habilidades do Claude Code com estrutura adequada, frontmatter e documentação.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "skill-writer". Ajude-me a criar uma habilidade para extrair texto de PDFs
Resultado esperado:
- Deixe-me ajudá-lo a criar uma habilidade de extração de texto de PDF.
- **Passo 1: Definir o escopo**
- - O que a habilidade faz: Extrair texto e tabelas de arquivos PDF
- - Quando usar: Ao trabalhar com arquivos PDF
- - Ferramentas necessárias: Read, Grep (operações de arquivo)
- **Passo 2: Escolher localização**
- - Uso pessoal: ~/.claude/skills/pdf-extractor
- - Uso em projeto: .claude/skills/pdf-extractor
- **Passo 3: Criar SKILL.md**
- Crie um arquivo com frontmatter YAML...
- Vou criar o arquivo SKILL.md completo com a estrutura adequada.
A utilizar "skill-writer". Minha habilidade não está sendo descoberta pelo Claude
Resultado esperado:
- Deixe-me verificar problemas comuns com a ativação de habilidades.
- **Problemas comuns:**
- 1. Descrição muito vaga ou genérica
- 2. Erros de sintaxe YAML no frontmatter
- 3. Caminho de arquivo incorreto
- 4. Nome do diretório não corresponde ao nome da habilidade
- Por favor, compartilhe o frontmatter e a descrição do seu SKILL.md para que eu possa ajudar a identificar o problema.
Auditoria de Segurança
SeguroAll static findings are false positives. The skill contains only documentation and guidance for creating Claude Code Skills. Scanner flagged YAML frontmatter delimiters (---) as cryptographic patterns and documentation shell examples as executable commands. No actual executable code, network calls, or file operations exist in this skill.
Fatores de risco
⚡ Contém scripts
🌐 Acesso à rede (1)
📁 Acesso ao sistema de arquivos (4)
⚙️ Comandos externos (55)
Pontuação de qualidade
O Que Você Pode Construir
Autor de Habilidade Iniciante
Um usuário que deseja criar sua primeira Habilidade de Agente, mas não conhece a estrutura de arquivos necessária, formato de frontmatter ou melhores práticas para descrições.
Desenvolvedor de Habilidades em Equipe
Um desenvolvedor criando habilidades compartilhadas para sua equipe, precisando de orientação sobre localizações de habilidades no nível do projeto, integração com git e convenções colaborativas.
Depurador de Habilidades
Um usuário cuja habilidade não está sendo ativada ou descoberta, precisando de ajuda para solucionar problemas de sintaxe YAML, caminhos de arquivos e palavras-gatilho de descrição.
Tente Estes Prompts
Ajude-me a criar uma nova Habilidade de Agente chamada [skill-name] que [what it does]. Usar quando [when to use it].
Crie uma Habilidade de Agente somente leitura que use apenas as ferramentas Read e Grep. A habilidade deve [description].
Criei uma habilidade mas o Claude não está usando ela. Meu arquivo SKILL.md está em [path]. A descrição é: [description]. Por que não está ativando?
Converta este fluxo de trabalho em uma Habilidade do Claude Code: [describe workflow steps]. Inclua estrutura adequada de SKILL.md com frontmatter, instruções e exemplos.
Melhores Práticas
- Mantenha habilidades focadas em uma única capacidade para melhorar a descoberta e reduzir conflitos
- Inclua palavras-gatilho específicas e tipos de arquivo nas descrições para melhorar a ativação
- Use frontmatter YAML com campos de nome e descrição claros com menos de 1024 caracteres
- Teste a ativação da habilidade fazendo perguntas que correspondam exatamente à descrição
Evitar
- Criar mega-habilidades que tentam fazer muitas coisas não relacionadas
- Usar descrições vagas como 'ajuda com documentos' ou 'analisa dados'
- Colocar scripts executáveis em SKILL.md sem sandboxing adequado
- Pular a etapa de teste e assumir que a habilidade funciona sem verificação
Perguntas Frequentes
Qual é a diferença entre habilidades pessoais e habilidades de projeto?
Como restrinjo quais ferramentas minha habilidade pode usar?
Por que minha habilidade não está ativando nas minhas consultas?
Posso ter habilidades com múltiplos arquivos?
Quais caracteres são permitidos em nomes de habilidades?
Preciso reiniciar o Claude Code depois de criar uma nova habilidade?
Detalhes do Desenvolvedor
Estrutura de arquivos
📄 SKILL.md