🔒 metadata.internal em profundidade
metadata.internal: true oculta a skill de npx skills find e do diretório skills.sh. Requer INSTALL_INTERNAL_SKILLS=1 para instalar. Ideal para skills de processos confidenciais.
Controle fino de visibilidade
Times corporativos frequentemente têm skills com informações sensíveis (senhas de processo, dados de clientes, propriedade intelectual). metadata.internal protege essas skills.
💡 Conceitos-chave
internal:true · INSTALL_INTERNAL_SKILLS · visibilidade · confidencialidade · processo corporativo
🔧 allowed-tools: restringindo ferramentas
O campo allowed-tools lista as ferramentas que o agente pode usar quando esta skill está ativa. Funciona em Claude Code, Cursor, Copilot e a maioria dos agentes.
Controle de permissões
Restringir ferramentas é essencial para skills de segurança: uma skill de code review não deve executar código, apenas ler. allowed-tools garante isso.
💡 Conceitos-chave
lista de ferramentas · permissões · segurança · Read · Write · Bash · restrição
⚡ context: fork no Claude Code
context: fork cria uma subconversa isolada para executar a skill. Mudanças de contexto não afetam a conversa principal. Feature exclusiva do Claude Code.
Contexto isolado
context: fork é poderoso para skills de transformação de código: a skill opera em contexto isolado e retorna apenas o resultado, sem poluir o histórico principal.
💡 Conceitos-chave
context:fork · isolamento · subconversa · Claude Code exclusivo · resultados limpos
🎣 Hooks: automação com eventos
Hooks executam código automaticamente quando eventos específicos ocorrem: pre-tool (antes de usar ferramenta), post-tool (depois), pre-compact (antes de compactar contexto).
Ações automáticas por evento
Hooks são a feature mais poderosa das skills avançadas. Use pre-tool para validar antes de executar, post-tool para registrar ações, pre-compact para salvar estado.
💡 Conceitos-chave
pre-tool · post-tool · pre-compact · Claude Code · Cline · automação por evento
📊 Compatibilidade: matrix de features
Features básicas (name, description, corpo) funcionam em todos os 50+ agentes. allowed-tools em quase todos. context:fork apenas Claude Code. Hooks: Claude Code e Cline.
O que funciona em cada agente
Escrever skills com graceful degradation — recursos avançados para Claude Code, mas skill funcional para todos — é a melhor prática para máxima compatibilidade.
💡 Conceitos-chave
matrix de compatibilidade · graceful degradation · features universais · Claude Code exclusivo · portabilidade
✅ Boas práticas para compatibilidade
Use allowed-tools para o que você quer suportar em todos. Use context:fork e hooks em skills marcadas como Claude-específicas. Separe em subpastas por nível de compatibilidade.
Escrevendo para múltiplos agentes
Skills em .claude/skills/ podem usar todas as features do Claude Code. Skills em skills/ devem ser compatíveis com todos. Organização comunica compatibilidade esperada.
💡 Conceitos-chave
organização por compatibilidade · .claude/skills/ · skills universais · comunicação de requisitos
✅ Resumo do Módulo
Próximo:
Trilha 4 — próxima trilha do curso