Claude Code: Agent Skills e skill-creator

Última atualização: 2026-08-31

Agent Skills são os "pacotes de habilidades profissionais" do Claude Code — instale uma Skill, e o Claude Code ganha um fluxo de trabalho profissional completo.

📋 Pré-requisitos: Capítulo 15 - Sistema de Memória

1. O Que Você Vai Aprender

• Conceito e arquitetura de Agent Skills
• Skills integradas e comunitárias
• Exemplos de uso de Skills
• Criando Skills customizados com skill-creator
• Melhores práticas de Skills

2. Conceito de Agent Skills

(1) O que é uma Skill

(2) Skill vs Instrução Simples

▶ Exemplo 1: Skill vs Instrução Simples

# Instrução simples
> Review this file's code quality
[Review de forma livre, pode pular aspectos]

# Usando Skill
> /skill code-review
[Segue o fluxo estruturado da Skill code-review]
  Step 1: Read file ✓
  Step 2: Security check ✓ (SQL injection, XSS, sensitive data exposure)
  Step 3: Performance check ✓ (N+1 queries, memory leaks)
  Step 4: Style check ✓
  Step 5: Generate report ✓
  All checkpoints passed

3. Skills Integradas e Comunitárias

(1) Skills Integradas

(2) Gerenciamento de Skills

# Listar Skills disponíveis
claude /skills

# Instalar Skill comunitária
claude /skill install @community/pr-review

# Ver detalhes da Skill
claude /skill info code-review

4. Exemplos de Uso de Skills

▶ Exemplo 2: Fluxo de Trabalho da Skill bug-fix

> /skill bug-fix "TypeError: Cannot read property 'id' of undefined at UserController.getProfile"

Claude Code [bug-fix Skill]:
  Step 1: Locate Bug ✓
    → Found: getProfile() accesses req.user.id without null check

  Step 2: Analyze Root Cause ✓
    → req.user is undefined when auth middleware fails silently

  Step 3: Design Fix ✓
    → Add null check in getProfile()
    → Fix auth middleware to throw on failure

  Step 4: Implement Fix ✓
    → Modifying UserController.ts and auth.ts

  Step 5: Verify Fix ✓
    → Running tests: 5/5 passed ✓

  Step 6: Prevent Recurrence ✓
    → Added edge case test for null user

  Bug fixed ✓ | 2 files modified | 1 test added

5. Criando Skills Customizados com skill-creator

(1) Estrutura de Definição de Skill

# .claude/skills/my-deployment.yaml
name: deployment
description: "Standardized deployment workflow"
trigger:
  keywords: ["deploy", "deployment"]

steps:
  - name: "Pre-check"
    actions:
      - "Confirm all tests pass"
      - "Check no uncommitted changes"
    checkpoints:
      - "npm test exit code = 0"
      - "git status clean"

  - name: "Build"
    actions:
      - "Run build command"
    checkpoints:
      - "build/ directory exists"

  - name: "Deploy"
    actions:
      - "Push code to remote"
      - "Trigger CI/CD pipeline"
    checkpoints:
      - "git push successful"

  - name: "Verify"
    actions:
      - "Wait for deployment"
      - "Access health check endpoint"
    checkpoints:
      - "HTTP 200 from /health"

output:
  format: "markdown"

▶ Exemplo 3: Usando skill-creator

> /skill-creator create a "database migration" Skill

Claude Code:
  I'll help you create a DB migration Skill. A few questions:
  1. Database tool? Prisma
  2. Migration steps? Modify schema, generate migration, run, verify
  3. Safety checks? Backup database, check reversibility
  4. Output format? Markdown report

  → Creating .claude/skills/db-migration.yaml
  → Skill created ✓
  Usage: /skill db-migration

6. Melhores Práticas de Skills

Quando Criar uma Skill

Princípios de Design

❓ Perguntas Frequentes

P: Diferença entre Skill e Plugin? R: Skills são definições de fluxo de trabalho (passos+checkpoints); plugins são extensões de funcionalidade (ferramentas+hooks). Skills usam ferramentas fornecidas por plugins, mas são conceitos independentes.

P: Skill garante qualidade? R: Não 100%. Skills fornecem fluxos estruturados e checkpoints, mas a qualidade de execução depende da capacidade do modelo. Operações críticas devem ter revisão humana.

P: Skills podem ser reutilizados entre projetos? R: Sim. Em ~/.claude/skills/ para global, .claude/skills/ para específico do projeto.

P: Skills gerados pelo skill-creator são bons? R: A primeira versão é usável mas precisa de refinamento. skill-creator gera o framework; você refina passos e checkpoints conforme suas necessidades.

📖 Resumo

• Skills são fluxos de trabalho estruturados: passos + checkpoints + formato de saída
• Skills integradas: code-review, bug-fix, security-audit, etc.
• /skill <name> aciona execução da Skill seguindo o fluxo
• skill-creator cria Skills customizados interativamente
• Fluxos de trabalho repetitivos e processos críticos se beneficiam de Skills; tarefas únicas não precisam

📝 Exercícios

1. Básico (⭐): Use a Skill integrada code-review para revisar um arquivo, compare com instrução simples.
2. Intermediário (⭐⭐): Use skill-creator para criar uma Skill customizada (ex: fluxo de deploy), teste a execução.
3. Avançado (⭐⭐⭐): Crie 3 Skills centrais para uma equipe cobrindo dev→teste→deploy com checkpoints completos.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós