← Voltar ao curso
Nível 1 — Fundamentos · Módulo 1.5 — Skills: ensine seu jeito uma vez só

1.5.1 · O que é uma Skill e por que ela dispara sozinha

4 min de vídeo TODOS

Objetivo: ao final, o consultor explica skill como conhecimento reutilizável ativado pela descrição, e entende por que ela não pesa no contexto.

O que você precisa levar desta aula

  1. Se você explica a mesma coisa duas vezes, é uma skill.
  2. A descrição é o gatilho: é ela que faz o Claude reconhecer quando usar a skill.
  3. Só nome e descrição ficam no contexto. Você pode ter dezenas de skills sem pesar nada.

O que é uma skill

Uma pasta com um arquivo SKILL.md dentro. O arquivo tem duas partes:

---
name: revisao-spec-funcional
description: Revisa uma spec funcional antes do envio ao cliente, usando o
  checklist da Wayon. Use ao revisar spec, FS ou especificação funcional.
---

# Revisão de spec funcional

Antes de aprovar o envio, verifique os doze itens abaixo e reporte cada um
como OK ou PENDENTE, com a evidência.

1. Toda regra de negócio tem o cenário de exceção correspondente
2. Todo campo novo tem tipo, tamanho e obrigatoriedade definidos
...

Como ela dispara

  1. Você escreve um pedido
  2. O Claude compara o pedido com a descrição de cada skill disponível
  3. As que casam são carregadas
  4. Ele aplica o procedimento

Você não invoca a skill. Ela é reconhecida. Isso é a diferença central em relação a um prompt salvo que você cola.

Por que não pesa no contexto

No contexto sempre No contexto só quando acionada
name e description de cada skill O corpo da skill

Uma skill com um procedimento de vinte páginas ocupa, em repouso, o espaço de duas linhas. É por isso que faz sentido escrever uma skill para cada procedimento que você repete: não existe custo em ter muitas.

Skill vs as outras formas de instruir

Comparação completa no módulo 2.4. Por agora, o essencial:

Forma Quando entra
Instruções do Project Sempre, dentro daquele Project
Skill Quando o Claude reconhece a tarefa, em qualquer Project
Prompt colado Quando você lembra de colar

Candidatos a skill no seu dia a dia

Perfil Candidatos imediatos
FUNC Checklist de revisão de spec; template de spec; derivação de casos de teste a partir da spec; formato de ata
TEC Padrão de revisão de código; convenção de nomenclatura; procedimento de transporte
BASIS Checklist de monitoramento; procedimento de análise de dump; runbook de rotina
PM Formato de status report; estrutura de proposta; checklist de preparação de comitê

📖 Agent Skills

Quiz — 4 questões

1.O que faz o Claude reconhecer que deve usar uma skill?
  • a)O nome da skill, se você mencioná-lo no pedido

    Você não precisa mencionar nada. Se precisasse, seria um slash command, não uma skill.

  • b)O conteúdo do procedimento

    O conteúdo não está no contexto até a skill ser acionada. Ele não pode ser o gatilho.

  • c)A descrição, comparada com o seu pedido

    Correto. É por isso que a descrição é a parte mais importante do arquivo.

Ver resposta e por quê
❌a) Você não precisa mencionar nada. Se precisasse, seria um slash command, não uma skill.
❌b) O conteúdo não está no contexto até a skill ser acionada. Ele não pode ser o gatilho.
✅c) Correto. É por isso que a descrição é a parte mais importante do arquivo.
2.Você quer ter 25 skills, uma para cada procedimento que repete. Isso:
  • a)Vai encher o contexto e degradar as respostas

    Só encheria se o conteúdo de todas estivesse carregado, e não está.

  • b)Funciona bem: só nome e descrição ficam no contexto

    Correto. O conteúdo entra só quando a skill é acionada, então não há custo em ter muitas.

  • c)Não é possível; há um limite de 5 skills

    Não é o mecanismo. O limite prático é a sua capacidade de manter as skills.

Ver resposta e por quê
❌a) Só encheria se o conteúdo de todas estivesse carregado, e não está.
✅b) Correto. O conteúdo entra só quando a skill é acionada, então não há custo em ter muitas.
❌c) Não é o mecanismo. O limite prático é a sua capacidade de manter as skills.
3.Qual é o sinal mais claro de que algo deveria ser uma skill?
  • a)É um procedimento longo

    Tamanho não é o critério. Existe procedimento longo que você usa uma vez por ano.

  • b)É específico de um cliente

    Se é específico de um cliente, o lugar é o Project (aula 1.4.4).

  • c)Você já explicou a mesma coisa ao Claude duas vezes

    Correto. Repetição é o critério, não tamanho nem complexidade.

Ver resposta e por quê
❌a) Tamanho não é o critério. Existe procedimento longo que você usa uma vez por ano.
❌b) Se é específico de um cliente, o lugar é o Project (aula 1.4.4).
✅c) Correto. Repetição é o critério, não tamanho nem complexidade.
4.Qual a diferença prática entre uma skill e um prompt que você salvou num arquivo e cola quando precisa? ---
  • a)A skill dispara sozinha quando ele reconhece a tarefa; o prompt colado depende de você lembrar

    Correto. É a diferença entre um procedimento que se aplica e um que você tem que aplicar.

  • b)Nenhuma; skill é só uma forma mais organizada de guardar prompts

    A diferença é o acionamento, e ela é grande.

  • c)A skill funciona em qualquer modelo, e o prompt não

    Ambos funcionam com qualquer modelo.

Ver resposta e por quê
✅a) Correto. É a diferença entre um procedimento que se aplica e um que você tem que aplicar.
❌b) A diferença é o acionamento, e ela é grande.
❌c) Ambos funcionam com qualquer modelo.