Princípios de escrita de habilidades para Claude Code a partir de 159 habilidades de código aberto

Um desenvolvedor publicou 10 princípios para escrever habilidades eficazes para o Claude Code, derivados da construção e manutenção de um registro de habilidades de código aberto com 159 habilidades. Os princípios focam em padrões de implementação prática observados através do uso real de agentes.
Princípios-chave para escrita de habilidades
- Não diga o óbvio - Empurre o Claude para além de seus padrões em vez de reforçá-los
- Seção de armadilhas - Considerado o conteúdo com maior retorno sobre investimento em qualquer habilidade
- Habilidades são pastas, não arquivos - Use subdiretórios references/, scripts/, assets/
- Não force um caminho único - Forneça diretrizes em vez de sequências rígidas de passos
- Configuração inicial via config.json - Coloque arquivos de configuração diretamente na pasta da habilidade
- O campo de descrição é uma condição de gatilho - Não apenas um resumo
- Dê memória às habilidades - Use logs, JSON ou SQLite entre execuções
- Envie scripts junto com a prosa - Exemplo: fetch_events.py é mais valioso que 200 linhas de explicação
- Ganchos sob demanda - Use blocos /careful para restringir comandos destrutivos apenas quando invocados
- Habilidades se compõem - Referencie outras habilidades pelo nome; o Claude as invocará se instaladas
Detalhes de implementação
Os princípios vêm do repositório AbsolutelySkilled (github.com/AbsolutelySkilled/AbsolutelySkilled), que contém 159 habilidades de código aberto. Todas as habilidades são instaláveis via npx skills add. O desenvolvedor enfatiza que esses padrões surgiram de observar como os agentes realmente usam as habilidades na prática, não de um design teórico.
Para desenvolvedores que constroem habilidades para agentes de codificação de IA, esses princípios fornecem orientação concreta sobre como estruturar habilidades de forma eficaz. O foco na implementação prática—como usar pastas em vez de arquivos únicos e incluir scripts reais em vez de apenas explicações—reflete padrões de uso do mundo real.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also

Corrigindo Problemas de Autonomia do Agente OpenClaw: Arquivos de Habilidades, Seleção de Ferramentas e Configuração do Cron
Um desenvolvedor compartilha soluções para agentes OpenClaw que param de funcionar autonomamente após a configuração inicial. As principais correções incluem usar arquivos de habilidades externos em vez de instruções de chat, substituir ferramentas de navegador por ferramentas baseadas em API ou scripts Puppeteer, e configurar corretamente os trabalhos cron.

Como Importar seu Histórico do ChatGPT para o Claude Usando Projetos
Exporte conversas do ChatGPT como arquivos Markdown e carregue as relevantes em Projetos do Claude para carregar anos de contexto, projetos em andamento e preferências de estilo.

Custos Iniciais da OpenClaw: Hardware, APIs e Orçamento Mensal
Nenhum

Como Proteger o Claude Cowork com uma Camada de Proxy: Guia Prático
Um guia prático sobre como configurar uma camada de proxy para observar e proteger o comportamento do Claude Cowork, publicado pela equipe General Analysis.