🤖 Agentes e Compatibilidade

Claude Code busca skills em .claude/skills/ (projeto) e ~/.claude/skills/ (global). O CLI instala nesses caminhos automaticamente.

Conhecer os caminhos permite inspecionar manualmente e resolver conflitos entre skills de projeto e globais.

.claude/skills/ · ~/.claude/skills/ · symlinks · inspeção manual · resolução de conflitos

context: fork cria uma subconversa completamente isolada. A skill opera com seu próprio contexto, histórico e estado.

Ideal para transformações: a skill analisa código em contexto isolado e retorna apenas o resultado processado.

context:fork · isolamento completo · subconversa · estado independente · resultado limpo

Hooks pre-tool executam antes de cada uso de ferramenta (validação, logging). Hooks post-tool executam depois (registro, cleanup).

Use pre-tool para evitar erros (verificar se arquivo existe antes de editar). Use post-tool para auditar ações.

pre-tool · post-tool · validação · logging · auditoria · automação

O hook pre-compact executa antes do Claude Code compactar o contexto. Permite salvar estado importante antes que ele seja comprimido.

Em sessões longas, contexto é compactado periodicamente. O pre-compact garante que informações críticas são preservadas.

pre-compact · compactação · preservação de estado · sessões longas · Claude Code

O Claude Code lê todos os arquivos .md em .claude/skills/ e os inclui no contexto do sistema. A description é usada para decisão de ativação.

Entender o processo de carregamento ajuda a diagnosticar problemas: skill não ativada, conteúdo não aplicado, conflitos.

carregamento · contexto do sistema · .md files · diagnóstico · conflitos

Exemplos: skill de review com hooks de logging, skill de deploy com pre-tool validation, skill de documentação com context:fork.

Ver exemplos concretos do uso de features exclusivas inspira a criar skills avançadas para seu próprio fluxo.

exemplos práticos · review com hooks · deploy validation · documentação · context:fork

npx skills add instala para todos os agentes detectados. Flags -a claude,cursor limitam. --all instala para todos.

O poder do Skills CLI está em instalar skills uma vez e ter disponível em todos os agentes que você usa.

detecção automática · múltiplos destinos · -a flag · --all · install simultâneo

Agentes têm modelos diferentes, prompts de sistema distintos e formas diferentes de incluir skills no contexto.

A mesma skill pode ter eficácia diferente em Claude Code vs Cursor. A description e os Steps devem ser testados em cada agente.

modelos diferentes · prompts de sistema · eficácia variável · teste por agente · calibração

Skills universais (pasta skills/) funcionam em todos. Skills específicas (pasta .claude/skills/) usam features exclusivas de um agente.

A estratégia híbrida é melhor: skill base em skills/ (para todos) + skill avançada em .claude/skills/ (para Claude Code).

estratégia híbrida · skills/ universal · .claude/skills/ específico · base + avançado

Tabela completa: skills básicas (todos), allowed-tools (quase todos), context:fork (Claude Code), hooks (Claude Code + Cline), metadata (todos).

A matrix é o documento de referência para decidir quais features usar ao criar uma skill com compatibilidade ampla.

matrix completa · features por agente · graceful degradation · referência

Escreva o núcleo da skill com features universais. Adicione features avançadas em arquivos separados para agentes específicos.

Máxima compatibilidade significa mais usuários. Uma skill que funciona em 50+ agentes tem muito mais impacto.

features universais · arquivos separados · impacto máximo · compatibilidade ampla

Processo de teste: ativar a skill em cada agente, verificar se a description é suficiente, testar os Steps, comparar resultados.

Testes cross-agent revelam problemas específicos de cada agente. Uma skill pode funcionar perfeitamente no Claude Code e mal no Cursor.

testes cross-agent · verificação · comparação de resultados · diagnóstico · qualidade