Guia de Agent Skills

As Agent Skills são capacidades reutilizáveis, baseadas no sistema de ficheiros, que expandem a funcionalidade do Claude. Empacotam conhecimento especializado de um domínio, fluxos de trabalho e boas práticas em componentes detetáveis que o Claude utiliza automaticamente quando são relevantes.

Descrição geral

As Agent Skills são capacidades modulares que transformam agentes de utilização geral em especialistas. Ao contrário dos prompts (instruções ao nível da conversa para tarefas pontuais), as Skills são carregadas a pedido e eliminam a necessidade de fornecer repetidamente as mesmas orientações em várias conversas.

Principais vantagens

• Especializar o Claude: Adaptar as capacidades a tarefas específicas de um domínio
• Reduzir a repetição: Criar uma vez, utilizar automaticamente em várias conversas
• Compor capacidades: Combinar Skills para construir fluxos de trabalho complexos
• Escalar fluxos de trabalho: Reutilizar skills em vários projetos e equipas
• Manter a qualidade: Incorporar boas práticas diretamente no seu fluxo de trabalho

As Skills seguem a norma aberta Agent Skills, que funciona em várias ferramentas de IA. O Claude Code expande a norma com funcionalidades adicionais, como o controlo de invocação, a execução em subagentes e a injeção dinâmica de contexto.

Nota: Os comandos slash personalizados foram integrados nas skills. Os ficheiros .claude/commands/ continuam a funcionar e suportam os mesmos campos de frontmatter. As skills são recomendadas para novos desenvolvimentos. Quando ambos existem no mesmo caminho (por exemplo, .claude/commands/review.md e .claude/skills/review/SKILL.md), a skill tem precedência.

Como funcionam as Skills: Divulgação progressiva

As Skills baseiam-se numa arquitetura de divulgação progressiva: o Claude carrega a informação em fases, conforme necessário, em vez de consumir contexto de imediato. Isto permite uma gestão eficiente do contexto, mantendo ao mesmo tempo uma escalabilidade ilimitada.

Três níveis de carregamento

graph TB
    subgraph "Level 1: Metadata (Always Loaded)"
        A["YAML Frontmatter"]
        A1["~100 tokens per skill"]
        A2["name + description"]
    end

    subgraph "Level 2: Instructions (When Triggered)"
        B["SKILL.md Body"]
        B1["Under 5k tokens"]
        B2["Workflows & guidance"]
    end

    subgraph "Level 3: Resources (As Needed)"