Gerenciar Habilidades de Agentes de IA

Você pode gerenciar habilidades e regras para todas as principais ferramentas de codificação de IA diretamente do terminal. Esta habilidade ensina a estrutura de diretórios, o formato de arquivo e as operações para cada ferramenta.

Quando Usar

Use esta habilidade quando o usuário quiser inspecionar, criar, editar, habilitar, desabilitar, copiar, mover ou excluir habilidades locais de agente de IA ou arquivos de regras em ferramentas de codificação compatíveis.

Ferramentas e Caminhos Suportados

Ferramentas baseadas em diretório (múltiplas habilidades)

Cada habilidade reside em seu próprio subdiretório com um arquivo SKILL.md contendo metadados YAML.

Ferramentas de arquivo único (um arquivo de configuração)

Plugins do Cursor (somente leitura)

As habilidades de plugin são armazenadas em cache em ~/.cursor/plugins/cache/<org>/<plugin>/<version>/skills/<name>/SKILL.md. Elas são gerenciadas pelo Cursor e não devem ser editadas diretamente.

Formato do Arquivo de Habilidade

Para ferramentas baseadas em diretório (Agents, Cursor, Claude), as habilidades usam metadados YAML:

---
name: skill-name
description: Brief description of what this skill does
---

# Skill Name

Skill instructions go here. The AI agent reads this content
when the skill is activated.

Para Windsurf, Cline, Continue e Roo Code, as habilidades são arquivos .md simples (metadados opcionais).

Operações

Listar todas as habilidades

# List skills for a specific tool
ls ~/.agents/skills/
ls ~/.cursor/skills/
ls ~/.claude/skills/
ls ~/.windsurf/rules/
ls ~/.cline/rules/
ls ~/.continue/rules/
ls ~/.roo/rules/

# Count total skills across all tools
echo "Agents: $(ls ~/.agents/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Cursor: $(ls ~/.cursor/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Claude: $(ls ~/.claude/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Windsurf: $(ls ~/.windsurf/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Cline: $(ls ~/.cline/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Continue: $(ls ~/.continue/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Roo: $(ls ~/.roo/rules/ 2>/dev/null | wc -l | tr -d ' ')"

# Check single-file tools
test -f ~/.github/copilot-instructions.md && echo "Copilot: exists" || echo "Copilot: not found"
test -f ~/.codex/AGENTS.md && echo "Codex: exists" || echo "Codex: not found"
test -f ~/.aider.conf.yml && echo "Aider: exists" || echo "Aider: not found"
test -f ~/augment-guidelines.md && echo "Augment: exists" || echo "Augment: not found"

Ler uma habilidade

cat ~/.cursor/skills/my-skill/SKILL.md

Criar uma nova habilidade

# For Agents/Cursor/Claude (SKILL.md format)
mkdir -p ~/.agents/skills/my-new-skill
cat > ~/.agents/skills/my-new-skill/SKILL.md << 'EOF'
---
name: my-new-skill
description: What this skill does
---

# My New Skill

Instructions for the agent go here.
EOF

# For Windsurf/Cline/Continue/Roo (plain .md format)
mkdir -p ~/.windsurf/rules/my-new-rule
cat > ~/.windsurf/rules/my-new-rule/my-new-rule.md << 'EOF'
# My New Rule

Instructions go here.
EOF

# For single-file tools
cat > .github/copilot-instructions.md << 'EOF'
Instructions for Copilot go here.
EOF

Habilitar / Desabilitar uma habilidade

Desabilitar renomeia o arquivo para .disabled para que a ferramenta o ignore, mas o conteúdo é preservado:

# Disable
mv ~/.cursor/skills/my-skill/SKILL.md ~/.cursor/skills/my-skill/SKILL.md.disabled

# Enable
mv ~/.cursor/skills/my-skill/SKILL.md.disabled ~/.cursor/skills/my-skill/SKILL.md

Copiar uma habilidade entre ferramentas

# Copiar do Cursor para o Claude
cp -r ~/.cursor/skills/minha-habilidade ~/.claude/skills/minha-habilidade

# Copiar do Agents para o Windsurf (adaptar formato)

…