OpenCode: OpenCode Skills System
Última atualização: 2026-08-31
--- title: Skills e Uso do OpenCode description: Aprenda o sistema Skills com capacidades de fluxo de trabalho especializado predefinidas order: 18 lang: pt-br
Skills são o sistema de habilidades predefinidas do OpenCode, proporcionando à IA fluxos de trabalho especializados e conhecimento.
1. O Que Você Vai Aprender
- Conceito e posicionamento das Skills
- Lista de Skills integradas
- Carregamento e uso de Skills
- Desenvolvimento de Skills personalizadas
2. O Que são Skills
Skills são templates de prompt predefinidos + fluxos de trabalho + bases de conhecimento que dão à IA capacidades especializadas em domínios específicos.
| Recurso | Descrição |
|---|---|
| Carregamento sob demanda | Não pré-carregadas, acionadas por palavras-chave |
| Templateadas | Fluxos de trabalho padronizados |
| Reutilizáveis | Uma Skill funciona em múltiplos projetos |
| Expansíveis | Desenvolva Skills personalizadas |
3. Mecanismo de Trigger das Skills
| Palavras-chave de Trigger | Skill Carregada |
|---|---|
| "nova", "desenvolver", "módulo", "funcionalidade" | brainstorming |
| "erro", "falha", "bug", "exceção" | systematic-debugging |
| Após aprovação do plano | writing-plans |
| "pronto", "corrigido", "completado" | verification-before-completion |
| Escrita de script, mudança de lógica | test-driven-development |
| Antes do commit | requesting-code-review |
| Tradução em lote, multilíngue | subagent-driven-development |
4. Skills Centrais
| Skill | Propósito |
|---|---|
| brainstorming | Explorar intenção, necessidades e design antes de trabalho criativo |
| writing-plans | Converter specs em planos de implementação passo a passo |
| executing-plans | Executar planos passo a passo sem desvio |
| systematic-debugging | Entender causa raiz antes de corrigir — não adivinhe |
| test-driven-development | Escrever teste falhando → impl mínima → passar (RED-GREEN-REFACTOR) |
| verification-before-completion | Rodar verificação antes de declarar conclusão — evidência antes de asserção |
| requesting-code-review | Scan de segurança pré-commit + gate de qualidade + auto-fix |
| subagent-driven-development | Despachar sub-agentes para tarefas paralelas em lote |
5. Skills Personalizadas
Diretório de Skills: ~/.config/opencode/skills/ (global) ou .opencode/skills/ (projeto)
Cada Skill é um arquivo Markdown com frontmatter definindo nome, descrição e triggers, e corpo com instruções do fluxo de trabalho.
❓ FAQ
P: Skills são carregadas automaticamente?
R: Não. Skills carregam sob demanda quando palavras-chave da tarefa correspondem. Isso economiza tokens.
P: Skills vs AGENTS.md?
R: AGENTS.md são regras do projeto (o que não fazer); Skills são fluxos de trabalho (como fazer tarefas específicas). São complementares.
📖 Resumo
- Skills são fluxos de trabalho especializados predefinidos
- Carregamento sob demanda via trigger de palavras-chave
- Skills centrais: brainstorming, debugging, TDD, verificação etc.
- Suporta desenvolvimento de Skills personalizadas
- Complementa AGENTS.md: regras + fluxos de trabalho
📝 Exercícios
-
Básico: Acione a Skill brainstorming no TUI e experimente brainstorming estruturado.
-
Intermediário: Acione a Skill systematic-debugging para depurar um bug sistematicamente.
-
Avançado: Desenvolva uma Skill personalizada definindo o fluxo de trabalho de revisão de código da sua equipe.
