📂 Estrutura de Skills no Claude Code
Claude Code descobre skills automaticamente em dois locais: ~/.claude/skills/ (global) e .claude/skills/ (projeto).
Locais de Skills
~/.claude/skills/ # Skills GLOBAIS (todos os projetos)
├── code-review/
│ └── SKILL.md
├── tdd/
│ └── SKILL.md
└── formatting/
└── SKILL.md
projeto/.claude/skills/ # Skills LOCAIS (apenas este projeto)
├── api-patterns/
│ └── SKILL.md
└── database-migrations/
└── SKILL.mdGlobal (~/.claude/skills/)
- • Disponivel em TODOS os projetos
- • Ideal para skills pessoais de uso geral
- • Code review, TDD, formatacao
Local (.claude/skills/)
- • Apenas neste projeto
- • Versionada com o codigo
- • Compartilhada com o time
🎯 Criando sua Primeira Skill
Criar uma skill e simples: uma pasta com um arquivo SKILL.md contendo frontmatter YAML e instrucoes em Markdown.
Passo a Passo
# 1. Criar pasta da skill
mkdir -p ~/.claude/skills/my-formatter
# 2. Criar SKILL.md
cat > ~/.claude/skills/my-formatter/SKILL.md << 'EOF'
---
name: my-formatter
description: Formats code following team standards. Use when
user asks to format, lint, or clean up code files.
allowed-tools: Bash(prettier:*), Bash(eslint:*)
---
# Code Formatter
## When to Use
- User asks to format code
- Before committing changes
- After generating new files
## Instructions
1. Run prettier on the file
2. Run eslint --fix
3. Report any remaining issues
## Commands
- Format: `prettier --write {file}`
- Lint: `eslint --fix {file}`
EOF🔧 Slash Commands Customizados
Skills podem ser invocadas como slash commands: /skill-name. O nome vem do frontmatter.
Invocando Skills
# Invocacao explicita via slash command
/my-formatter # Ativa a skill
/my-formatter src/app.js # Ativa com argumento
# Ativacao automatica (via description)
"Formate o arquivo utils.ts" # Detecta e ativa
# Listar skills disponiveis
/skills # Mostra todas as skills💡 Dica de Nomes
Use nomes curtos e memoraveis para suas skills. Eles viram slash commands, entao /fmt e melhor que /my-super-awesome-code-formatter-v2.
📦 Skills com Recursos
Skills podem incluir arquivos adicionais: scripts, templates e configuracoes.
Estrutura com Recursos
my-skill/
├── SKILL.md # Obrigatorio
├── scripts/
│ ├── validate.py # Script de validacao
│ └── generate.sh # Script de geracao
├── templates/
│ ├── component.tsx.tmpl # Template de componente
│ └── test.ts.tmpl # Template de teste
└── resources/
└── design-tokens.json # ConfiguracoesReferenciando Recursos no SKILL.md
## Scripts Disponiveis
Para validar: execute `./scripts/validate.py {arquivo}`
Para gerar: use o template em `./templates/component.tsx.tmpl`
## Design Tokens
As cores e fontes estao em `./resources/design-tokens.json`🧪 Testando Skills
Teste suas skills antes de compartilhar. Verifique se ativam corretamente e produzem resultados esperados.
Checklist de Teste
- 1.Descoberta: Execute
/skillse verifique se aparece - 2.Slash command: Invoque com
/nome-da-skill - 3.Ativacao automatica: Use prompts naturais e veja se ativa
- 4.Resultado: Verifique se as instrucoes sao seguidas
Problemas Comuns
- • Skill nao aparece: Verifique se SKILL.md existe e tem frontmatter valido
- • Nao ativa automaticamente: Melhore a description com mais keywords
- • Permissoes negadas: Verifique allowed-tools no frontmatter
📤 Compartilhando Skills
Skills podem ser compartilhadas via Git, como submodulos ou copiando para repositorios.
Via Git (Projeto)
# Skills em .claude/skills/ sao
# versionadas automaticamenteIdeal para skills especificas do projeto.
Via Repositorio
git clone repo ~/.claude/skills/skill-nameIdeal para skills reutilizaveis.
📚 Resumo do Modulo
Proximo Modulo:
2.5 - Hooks e Automacao