Agent Skills: O Fim dos Prompts Gigantes

Você ainda copia e cola o mesmo prompt de 500 linhas toda vez que abre uma nova conversa?

Se sim, você está fazendo do jeito errado.

Não é culpa sua. A maioria das pessoas trata a IA como um bloco de notas — despeja instruções, reza para funcionar, e repete o processo do zero amanhã.

O problema? Instruções voláteis evaporam. Cada nova sessão começa em zero. Cada contexto precisa ser reconstruído. É como contratar um funcionário com amnésia permanente.

Existe um jeito melhor.

O Que São Agent Skills?

Pense na diferença entre um chef e um livro de receitas.

O livro de receitas é um prompt gigante. Você lê, interpreta, segue os passos. Se errar, volta pro começo. Se mudar de receita, descarta tudo e começa de novo.

O chef é diferente. Ele incorporou as técnicas. Sabe quando o ponto está certo pelo som do óleo. Adapta receitas no instante. Combina habilidades de formas que nenhum livro ensina.

Agent Skills transformam sua IA de livro de receitas em chef.

Em vez de instruções descartáveis, você cria capacidades modulares e permanentes.

Os 3 Pilares das Skills

Pilar	O Que Significa	Por Que Importa
Modularidade	Cada skill é uma pasta com SKILL.md	Organize, combine, reutilize
Portabilidade	Zipe e envie ou use via Git	Funciona em qualquer máquina
Determinismo	Scripts (Python/Bash) para tarefas lógicas	Zero alucinação em cálculos

A Anatomia de Uma Skill: Por Que Ela é 10x Mais Eficiente

Aqui está o segredo que poucos entendem: skills não carregam tudo de uma vez.

Prompts gigantes? Consomem contexto antes de você perguntar qualquer coisa.

Skills inteligentes? Carregam apenas o necessário, no momento certo.

Os 3 Níveis de Carregamento

┌─────────────────────────────────────────────────────────┐
│  NÍVEL 1: METADADOS (Sempre carregado)                  │
│  → Nome + Descrição                                     │
│  → Custo: ~50 tokens                                    │
│  → A IA sabe que a skill EXISTE                         │
├─────────────────────────────────────────────────────────┤
│  NÍVEL 2: INSTRUÇÕES (Carregado no match)               │
│  → Regras detalhadas, exemplos, padrões                 │
│  → Custo: 500-2000 tokens                               │
│  → Ativado quando você PRECISA da skill                 │
├─────────────────────────────────────────────────────────┤
│  NÍVEL 3: EXECUÇÃO (Sob demanda)                        │
│  → Scripts Python/Bash, arquivos de dados               │
│  → Custo: variável                                      │
│  → Roda apenas quando a tarefa EXIGE                    │
└─────────────────────────────────────────────────────────┘

Na prática: uma biblioteca de 50 skills custa menos contexto que um único prompt de "sistema completo".

Onde Usar: Claude Code, Cursor e Antigravity

Três ferramentas. Três abordagens. Uma estrutura compatível.

Claude Code: O Terminal que Pensa

O Claude Code roda direto no seu terminal. Sem interface bonita, sem limitações de browser.

# Estrutura de uma skill no Claude Code
.claude/
└── skills/
    └── code-reviewer/
        ├── SKILL.md          # Instruções da skill
        ├── checklist.md      # Recursos auxiliares
        └── review.py         # Script de automação

Quando usar: Automação local, pipelines de deploy, tarefas que precisam de acesso total ao sistema.

Cursor AI: Skills no IDE

O Cursor permite importar skills direto do GitHub e usar no seu editor de código.

# Importar skill do GitHub
cursor rules import github.com/user/skill-repo

Dica: Se você já usa Dynamic Rules, migre para Skills:

/migrate-to-skills

Quando usar: Desenvolvimento de software, code review no contexto do projeto, refatoração.

Antigravity: Skills Visuais

O Antigravity foca em criação via linguagem natural. Skills aqui garantem consistência visual.

Quando usar: Design de interfaces, prototipagem rápida, assets visuais.

5 Skills Que Todo Dev Deveria Ter

1. Code Reviewer

Padroniza a qualidade do time sem precisar de reunião.

# SKILL.md - Code Reviewer

## Objetivo
Revisar código seguindo os padrões do time.

## Checklist Obrigatório
- [ ] Nomes de variáveis seguem convenção (camelCase)
- [ ] Funções têm no máximo 20 linhas
- [ ] Imports organizados (externos → internos)
- [ ] Sem console.log em produção
- [ ] Tipos TypeScript explícitos (sem `any`)

## Output Esperado
Lista de issues com linha, severidade e sugestão de fix.

2. Troubleshooter

O manual de diagnóstico que nunca esquece um erro.

# SKILL.md - Troubleshooter

## Objetivo
Diagnosticar e resolver erros comuns do projeto.

## Base de Conhecimento
- ECONNREFUSED → Verificar se o serviço está rodando
- CORS error → Checar headers no backend
- Hydration mismatch → Verificar uso de useEffect

## Processo
1. Identificar a mensagem de erro exata
2. Buscar na base de conhecimento
3. Se não encontrar, analisar stack trace
4. Propor solução com código

3. Brand Guardian

Garante que a IA nunca erre as cores da sua marca.

# SKILL.md - Brand Guardian

## Paleta de Cores
- Primary: #FF4400 (laranja)
- Background: #14120B (escuro)
- Text: #FAFAFA (claro)

## Tipografia
- Títulos: Figtree Bold
- Corpo: Figtree Regular

## Tom de Voz
- Direto, sem jargões corporativos
- Técnico mas acessível
- Nunca use: "revolucionário", "inovador", "disruptivo"

4. Commit Writer

Mensagens de commit consistentes, sempre.

# SKILL.md - Commit Writer

## Formato
tipo(escopo): descrição curta

## Tipos Permitidos
- feat: nova funcionalidade
- fix: correção de bug
- refactor: mudança sem alterar comportamento
- docs: documentação
- test: testes

## Regras
- Máximo 50 caracteres no título
- Sempre em português
- Verbo no imperativo

5. API Designer

Endpoints consistentes em todo o projeto.

# SKILL.md - API Designer

## Convenções REST
- GET /recursos → listar
- GET /recursos/:id → detalhe
- POST /recursos → criar
- PUT /recursos/:id → atualizar completo
- PATCH /recursos/:id → atualizar parcial
- DELETE /recursos/:id → remover

## Response Padrão
{
  "data": {},
  "meta": { "timestamp": "ISO8601" },
  "errors": []
}

Como Criar Sua Primeira Skill em 5 Minutos

Passo 1: Crie a Estrutura

mkdir -p .claude/skills/minha-skill
touch .claude/skills/minha-skill/SKILL.md

Passo 2: Defina o SKILL.md

---
name: "Minha Skill"
description: "O que essa skill faz em uma frase"
triggers:
  - "palavra-chave-1"
  - "palavra-chave-2"
---

# Minha Skill

## Objetivo
[O que essa skill resolve]

## Quando Usar
[Situações específicas]

## Processo
1. [Passo 1]
2. [Passo 2]
3. [Passo 3]

## Output
[O que a skill deve produzir]

Passo 3: Teste

# No Claude Code
claude "use minha-skill para [tarefa]"

O Futuro é Componível

A pergunta não é mais "qual IA usar?"

A pergunta é: qual biblioteca de skills você construiu?

Pense nisso:

Sem skills: Cada conversa começa do zero. Você é o prompt.
Com skills: Cada conversa constrói sobre capacidades existentes. A IA evolui.

O futuro não é criar IAs novas. É compor bibliotecas de habilidades que se combinam de formas que nem você imaginava.

Um desenvolvedor com 50 skills bem construídas entrega mais que uma equipe de 5 copiando prompts do ChatGPT.

Próximos Passos

Identifique padrões repetitivos no seu trabalho
Extraia a lógica para um SKILL.md
Teste, refine, compartilhe

Comece com uma skill. Depois duas. Em um mês, você terá uma biblioteca que trabalha por você.

A IA não substitui desenvolvedores. Desenvolvedores com skills substituem os sem.