Glossário
49 termos de “Claude Code Skills: crie seus próprios fluxos de trabalho com IA”. Passe o cursor sobre a primeira ocorrência na lição para ver a definição.
| Termo | Definição | Fonte |
|---|---|---|
| Skill | Um diretório contendo um arquivo SKILL.md: um pacote reutilizável de instruções de fluxo de trabalho que diz ao Claude como executar uma tarefa específica. | Blog de engenharia da Anthropic: Equipping agents for the real world with Agent Skills |
| SKILL.md | O arquivo central de uma Skill, contendo duas partes: frontmatter YAML (metadados) e instruções em Markdown (as orientações que o Claude segue). | Documentação oficial do Claude Code: Extend Claude Code with skills |
| YAML frontmatter | O bloco de metadados no topo do SKILL.md, delimitado por marcadores de traço triplo (---), contendo campos como name e description. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| name | Um campo obrigatório do frontmatter que define o identificador único da Skill; ele se torna o comando e deve usar letras minúsculas, dígitos e hifens. | Blog de engenharia da Anthropic: Equipping agents for the real world with Agent Skills |
| description | Um campo obrigatório do frontmatter que diz ao Claude o que a Skill faz e quando usá-la. É a única base para o acionamento automático. | Building skills for Claude, na prática: frontmatter YAML e testes |
| acionamento automático | Quando o que o usuário diz combina com a description de uma Skill, o Claude carrega e executa aquela Skill por conta própria, sem comando manual. | Building skills for Claude, na prática: frontmatter YAML e testes |
| invocação manual | Chamar uma Skill diretamente com /nome-da-skill, o que força o Claude a carregá-la sem depender da correspondência da description. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| instruções em Markdown | Tudo no SKILL.md depois do frontmatter: as orientações concretas passo a passo que o Claude segue, escritas em Markdown. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| revelação progressiva | Dar ao Claude apenas o que ele precisa agora em vez de despejar todos os detalhes de uma vez, para que a Skill fique curta e carregue rápido. | Documentação da plataforma da Anthropic: Agent Skills overview |
| arquivos de apoio | Arquivos no diretório de uma Skill além do SKILL.md (checklists, configuração, scripts) que são carregados sob demanda e não consomem contexto inicial. | Documentação da plataforma da Anthropic: Agent Skills overview |
| skills pessoais | Skills armazenadas em ~/.claude/skills/, disponíveis apenas para você mas utilizáveis em todos os projetos. Boas para hábitos pessoais e ferramentas de uso geral. | Teach Claude Code your workflow: guia prático de skills personalizadas |
| skills de projeto | Skills armazenadas no diretório .claude/skills/ de um projeto, commitadas no Git para que os colegas as recebam automaticamente ao clonar o repositório. | Teach Claude Code your workflow: guia prático de skills personalizadas |
| Repetição | Uma das três características que fazem um cenário combinar com uma Skill: você faz a mesma coisa diariamente, semanalmente, às vezes de hora em hora. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Passos fixos | Uma das três características que fazem um cenário combinar com uma Skill: o processo pode ser escrito como passos claros em vez de mudar toda vez. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Verificável | Uma das três características que fazem um cenário combinar com uma Skill: você consegue dizer se o Claude acertou o resultado. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| fórmula da description | A diretriz para escrever uma description eficaz: o que ela faz + quando usá-la + principais capacidades. | Building skills for Claude, na prática: frontmatter YAML e testes |
| palavras-gatilho | As palavras em uma description que um usuário poderia plausivelmente dizer; o Claude combina com elas para decidir se auto-carrega a Skill. | Building skills for Claude, na prática: frontmatter YAML e testes |
| Formato de entrada | A seção de instruções que especifica que tipo de entrada a Skill aceita, incluindo forma, fonte e um exemplo concreto. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Passos de processamento | As operações ordenadas e concretas que a Skill executa; o coração das instruções, onde cada passo deve ser específico o suficiente para ser inequívoco. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Formato de saída | A seção de instruções que define como o resultado deve parecer, incluindo estrutura, símbolos e um exemplo trabalhado. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| casos de borda | Entradas incomuns ou anormais (entrada vazia, entrada malformada, conteúdo muito longo) cujo tratamento deve ser explicitado nas instruções. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| invocação direta | O teste mais simples: chamar a Skill com /nome-da-skill e observar se a saída corresponde às expectativas. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| casos de teste | Pares preparados de entrada-e-saída-esperada usados para testar uma Skill sistematicamente antes de confiar nela. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| ciclo de iteração | O ciclo testar-encontrar-corrigir-retestar pelo qual uma Skill passa; o caminho de 'funciona' para 'funciona bem'. | Claude Code skills: fluxos de trabalho .NET e prompts reutilizáveis |
| A/B | Executar a mesma tarefa com e sem a Skill e cronometrar ambas, para provar se a Skill é realmente mais rápida e consistente. | Claude Code skills: fluxos de trabalho .NET e prompts reutilizáveis |
| padrão de checklist | Organizar uma tarefa complexa como uma série de itens de verificação explícitos, cada um dos quais pode passar ou falhar independentemente. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| fluxo de trabalho com múltiplos passos | Uma Skill que executa vários passos sequenciais para completar uma tarefa complexa, onde a saída de um passo pode alimentar o próximo. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Graduar a saída | Dividir os achados de uma Skill por severidade (passou, vale uma olhada, precisa corrigir) para que o leitor saiba no que agir primeiro. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| controle de versão | Gerenciar skills de projeto com Git para que você possa ver histórico, reverter e comparar versões, da mesma forma que gerencia código. | Claude Code skills: fluxos de trabalho .NET e prompts reutilizáveis |
| Revisar uma Skill | Revisar uma Skill nova ou modificada como você revisa código: checar a description, as instruções e os testes antes de fazer merge. | Skills do Claude como runbooks autodocumentados |
| convenção de nomes | Um estilo acordado por todo o time para nomes de Skill: hifens, ordem verbo-substantivo ou substantivo-verbo, duas ou três palavras. | Claude Code skills: fluxos de trabalho .NET e prompts reutilizáveis |
| poda com regularidade | Revisar todas as Skills uma vez por trimestre e deletar ou melhorar as que mal são usadas, para que uma pilha não utilizada não obstrua as escolhas do Claude. | Claude Code skills: fluxos de trabalho .NET e prompts reutilizáveis |
| anuncie as mudanças | Após mudar uma Skill existente, postar a mudança e seu impacto no canal do time para que as pessoas não operem a nova Skill com suposições antigas. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Compor Skills | Encadear várias Skills de propósito único para lidar com uma tarefa maior, ou referenciar uma Skill de dentro de outra. | Blog de engenharia da Anthropic: Equipping agents for the real world with Agent Skills |
| allowed-tools | Um campo opcional do frontmatter que restringe uma Skill a um conjunto especificado de ferramentas, traçando uma fronteira de permissão para casos sensíveis à segurança. | Claude Skills em profundidade (uma visão a partir dos primeiros princípios) |
| disable-model-invocation | Um campo opcional do frontmatter que, quando definido, impede o Claude de auto-carregar a Skill, deixando apenas invocação manual, para evitar acionamentos acidentais. | Claude Skills em profundidade (uma visão a partir dos primeiros princípios) |
| model | Um campo opcional do frontmatter que fixa um modelo específico para a Skill, por exemplo um modelo de raciocínio mais forte quando a tarefa precisa dele. | Claude Skills em profundidade (uma visão a partir dos primeiros princípios) |
| servidor MCP | Um servidor Model Context Protocol que fornece ferramentas (acesso a banco de dados, chamadas de API) ao Claude; uma Skill fornece o conhecimento de fluxo de trabalho para usá-las. | The complete guide to building skills for Claude (PDF) |
| Skills da comunidade | Skills construídas e compartilhadas por outros desenvolvedores, encontráveis no GitHub e em outros lugares. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Documentar Skills | Listar toda skill de projeto, com uso e exemplos, no README do projeto ou em .claude/README.md. | Skills do Claude como runbooks autodocumentados |
| responsabilidade única | Cada Skill deve fazer uma coisa e fazer bem, em vez de tentar resolver vários problemas não relacionados em uma Skill. | Blog de engenharia da Anthropic: Equipping agents for the real world with Agent Skills |
| contexto | Quando o Claude carrega uma Skill, o conteúdo do SKILL.md ocupa a janela de contexto; quanto mais longo o arquivo, mais ele consome. | Documentação da plataforma da Anthropic: Agent Skills overview |
| carregadas sob demanda | Conteúdo de arquivo de apoio é lido apenas quando o Claude realmente precisa dele, de modo que não ocupa contexto no carregamento inicial da Skill. | Documentação da plataforma da Anthropic: Agent Skills overview |
| falsos positivos | Quando uma Skill sinaliza código ou conteúdo normal como problema; corrija adicionando uma categoria 'precisa de confirmação' ou ajustando os critérios. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Escapes | Quando uma Skill falha em detectar um problema que deveria ter encontrado; corrija adicionando regras de verificação ou ajustando a lógica de julgamento. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| falha de carregamento | Quando uma Skill não auto-carrega ou uma chamada manual falha, o processo de diagnóstico de verificar caminho do arquivo, formato do frontmatter e grafia do nome nessa ordem. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| Exemplos | Fornecer exemplos de entrada/saída para que o Claude entenda o comportamento esperado; um exemplo trabalhado faz mais do que descrição em prosa. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| branch de feature | Criar ou mudar uma Skill experimental em uma branch do Git e fazer merge para main apenas quando ela merecer, para que o time não seja interrompido. | Documentação oficial do Claude Code: Extend Claude Code with skills |
| conhecimento de fluxo de trabalho | Conhecimento sobre como organizar passos, quando usar qual ferramenta e como julgar o resultado; o valor central que uma Skill fornece. | The complete guide to building skills for Claude (PDF) |