Criador de Habilidades

Esta habilidade fornece orientação para a criação de habilidades eficazes.

Sobre Habilidades

Habilidades são pacotes modulares e autônomos que expandem as capacidades do Claude ao fornecer conhecimento especializado, fluxos de trabalho e ferramentas. Pense nelas como "guias de integração" para domínios ou tarefas específicas — elas transformam o Claude de um agente de propósito geral em um agente especializado equipado com conhecimento procedural que nenhum modelo pode possuir completamente.

O que as Habilidades Oferecem

1. Fluxos de trabalho especializados - Procedimentos de várias etapas para domínios específicos
2. Integrações de ferramentas - Instruções para trabalhar com formatos de arquivo ou APIs específicas
3. Expertise de domínio - Conhecimento específico da empresa, esquemas, lógica de negócios
4. Recursos agrupados - Scripts, referências e ativos para tarefas complexas e repetitivas

Anatomia de uma Habilidade

Cada habilidade consiste em um arquivo SKILL.md obrigatório e recursos agrupados opcionais:

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/          - Executable code (Python/Bash/etc.)
    ├── references/       - Documentation intended to be loaded into context as needed
    └── assets/           - Files used in output (templates, icons, fonts, etc.)

SKILL.md (obrigatório)

Qualidade dos Metadados: O name e o description no frontmatter YAML determinam quando o Claude usará a habilidade. Seja específico sobre o que a habilidade faz e quando usá-la. Use a terceira pessoa (por exemplo, "Esta habilidade deve ser usada quando..." em vez de "Use esta habilidade quando...").

Recursos Agrupados (opcional)

Scripts (scripts/)

Código executável (Python/Bash/etc.) para tarefas que exigem confiabilidade determinística ou são reescritas repetidamente.

• Quando incluir: Quando o mesmo código está sendo reescrito repetidamente ou confiabilidade determinística é necessária
• Exemplo: scripts/rotate_pdf.py para tarefas de rotação de PDF
• Benefícios: Eficiente em tokens, determinístico, pode ser executado sem carregar no contexto
• Observação: Scripts ainda podem precisar ser lidos pelo Claude para correção ou ajustes específicos do ambiente

Referências (references/)

Documentação e material de referência destinados a serem carregados conforme necessário no contexto para informar o processo e o raciocínio do Claude.

• Quando incluir: Para documentação que o Claude deve referenciar enquanto trabalha
• Exemplos: references/finance.md para esquemas financeiros, references/mnda.md para modelo de NDA da empresa, references/policies.md para políticas da empresa, references/api_docs.md para especificações de API
• Casos de uso: Esquemas de banco de dados, documentação de API, conhecimento de domínio, políticas da empresa, guias de fluxo de trabalho detalhados
• Benefícios: Mantém o SKILL.md enxuto, carregado apenas quando o Claude determina que é necessário
• Melhor prática: Se os arquivos forem grandes (>10 mil palavras), inclua padrões de busca grep no SKILL.md
• Evite duplicação: As informações devem residir no SKILL.md ou nos arquivos de referência, não em ambos. Prefira arquivos de referência para informações detalhadas, a menos que sejam realmente centrais para a habilidade — isso mantém o SKILL.md enxuto enquanto torna as informações descobertas sem sobrecarregar a janela de contexto. Mantenha apenas instruções procedimentais essenciais e orientação de fluxo de trabalho no SKILL.md; mova material de referência detalhado, esquemas e exemplos para arquivos de referência.

Ativos (assets/)

Arquivos que não se destinam a serem carregados no contexto, mas sim usados na saída que o Claude produz.

• Quando incluir: Quando a habilidade precisa de arquivos que serão usados na saída final
• Exemplos: assets/logo.png para ativos de marca, assets/slides.pptx para modelos de PowerPoint, assets/frontend-template/ para boilerplate HTML/React, assets/font.ttf para tipografia
• Casos de uso: Modelos, imagens, ícones, boilerplate de código, fontes, documentos de exemplo que são copiados ou modificados
• Benefícios: Separa os recursos de saída da documentação, permite que o Claude use arquivos sem carregá-los no contexto

Princípio de Design de Divulgação Progressiva

As habilidades usam um sistema de carregamento de três níveis para gerenciar o contexto de forma eficiente:

1. Metadados (nome + descrição) - Sempre em contexto (~100 palavras)
2. Corpo do SKILL.md - Quando a habilidade é acionada (<5 mil palavras)
3. Recursos agrupados - Conforme necessário pelo Claude (Ilimitado*)

*Ilimitado porque scripts podem ser executados sem ler na janela de contexto.

Processo de Criação de Habilidade

…