Skill Creator

• Criando uma nova skill do zero — Você tem um domínio, fluxo de trabalho ou integração de ferramenta que deseja empacotar como uma skill reutilizável e precisa de orientação sobre estrutura, conteúdo e boas práticas.
• Melhorando uma skill existente — Você tem uma skill que não está sendo acionada de forma confiável, está sobrecarregando a janela de contexto ou não possui recursos úteis agrupados e deseja uma revisão criteriosa.
• Projetando a arquitetura de uma skill — Você não tem certeza de como dividir o conteúdo entre SKILL.md, scripts/, references/ e assets/, e quer um framework para tomar essas decisões.
• Empacotando e distribuindo uma skill — Você está pronto para validar e empacotar um diretório de skill em um arquivo .skill para compartilhamento.

• Você só quer usar uma skill existente — Esta skill é especificamente para criar skills, não para usá-las em tarefas de domínio.
• Sua tarefa é pontual — Se você só precisa que o Claude execute uma tarefa especializada uma única vez e não pretende reutilizá-la, criar um pacote de skill completo é exagero.

Guia o Claude por um processo repetível: entender a skill com exemplos concretos, planejar conteúdos reutilizáveis, inicializar o diretório, editar o SKILL.md e os recursos, empacotar a skill e iterar. Cada etapa possui critérios claros de entrada e saída, garantindo que nenhuma seja pulada sem uma boa razão.

As skills utilizam um sistema de carregamento em três níveis — metadados (~100 palavras, sempre no contexto), corpo do SKILL.md (carregado ao ser acionado, mantido abaixo de 500 linhas) e recursos agrupados (carregados somente quando necessário). Esta skill ensina você a aplicar esse princípio para que suas skills permaneçam enxutas e eficientes no uso do contexto.

Explica quando dar ao Claude alta liberdade (instruções em texto aberto), média liberdade (pseudocódigo com parâmetros) ou baixa liberdade (scripts específicos com variação mínima). Ajustar a especificidade à fragilidade da tarefa é fundamental para escrever skills eficazes.

Abrange os três tipos de recursos — scripts/ para código executável determinístico, references/ para documentação carregada sob demanda e assets/ para arquivos de saída como templates e imagens. Fornece exemplos concretos e orientações sobre quando cada tipo é adequado.

Utiliza init_skill.py para criar a estrutura de um novo diretório de skill com frontmatter adequado, instruções de placeholder e pastas de recursos de exemplo. Utiliza package_skill.py para validar a estrutura, verificar a qualidade da descrição e gerar um arquivo zip .skill distribuível.

O campo description é o principal mecanismo de acionamento — ele deve declarar claramente o que a skill faz e quando usá-la. Esta skill fornece orientações explícitas e exemplos para escrever descrições que acionem a skill certa no momento certo de forma confiável.

Uma equipe quer que Claude responda perguntas usando esquemas internos de banco de dados, especificações de API e políticas de negócios. Usando o Skill Creator, eles planejam um diretório references/ com arquivos divididos por domínio (finance.md, sales.md), escrevem um SKILL.md objetivo e empacotam tudo para distribuição à equipe.

Um usuário frequentemente pede ao Claude para rotacionar, extrair texto ou preencher formulários em PDFs. O Skill Creator o guia para identificar o código repetido, criar um scripts/rotate_pdf.py e escrever um SKILL.md que instrui o Claude sobre quando e como utilizá-lo — eliminando a geração redundante de código a cada sessão.

Um desenvolvedor quer que o Claude sempre inicie novos aplicativos web a partir de um boilerplate React consistente. O Skill Creator o orienta a armazenar o template em assets/hello-world/ e escrever instruções que dizem ao Claude para copiar e adaptar esse template em vez de escrever o boilerplate do zero a cada vez.

Uma skill existente não está sendo invocada quando esperado. A orientação do Skill Creator sobre frontmatter descriptions — especificamente colocar todo o contexto de "quando usar" no campo description, e não no corpo — ajuda a diagnosticar e corrigir o problema de acionamento.