Guia de OpenCode Skills: 7 regras para fluxos reutilizáveis de IA

OpenCode skills são pacotes reutilizáveis de instruções para trabalho de programação repetido. Use uma skill quando quiser que o OpenCode mantenha um procedimento, uma regra de domínio ou um padrão de revisão. Não use skill como cofre de segredos nem como substituta de agent ou MCP. Uma skill vale a pena quando a mesma instrução aparece em muitos prompts. Uma nota única fica no prompt; uma preferência permanente pertence à configuração ou documentação.

Uma skill vale a pena quando a mesma instrução aparece em muitos prompts. Uma nota única fica no prompt; uma preferência permanente pertence à configuração ou documentação.

O teste correto é comparar uma tarefa pequena com e sem a skill. Se ela reduz explicação repetida e melhora o diff, mantenha; se só adiciona política vaga, corte.

Skills de projeto são mais fáceis de revisar porque ficam perto do código afetado. Uma skill global pode alterar outros repositórios, então reserve-a para hábitos realmente universais.

Quando uma skill menciona framework, deploy, voz editorial ou regra de conformidade, normalmente ela pertence ao projeto.

Uma skill vale a pena quando a mesma instrução aparece em muitos prompts. Uma nota única fica no prompt; uma preferência permanente pertence à configuração ou documentação.

Skill orienta comportamento; command inicia uma ação nomeada; agent separa papel e contexto; MCP conecta ferramentas externas.

Skills de projeto são mais fáceis de revisar porque ficam perto do código afetado. Uma skill global pode alterar outros repositórios, então reserve-a para hábitos realmente universais.

Escreva a skill como contrato revisável: objetivo, gatilho, passos, limites e evidência esperada. Se não pode ser testada, está ampla demais.

Uma skill vale a pena quando a mesma instrução aparece em muitos prompts. Uma nota única fica no prompt; uma preferência permanente pertence à configuração ou documentação.

Comece com um template mínimo e troque marcadores por comandos reais do repositório. Skills pequenas são mais fáceis de manter.

---
name: repository-review
description: Use when reviewing code changes in this repository.
---

# Repository Review

1. Inspect the changed files and nearby tests before giving findings.
2. Prioritize bugs, regressions, security risks, and missing validation.
3. Run the documented test command when the touched area has one.
4. Report findings first with file and line references.
5. If no issue is found, say so and mention residual test risk.

Skills de projeto são mais fáceis de revisar porque ficam perto do código afetado. Uma skill global pode alterar outros repositórios, então reserve-a para hábitos realmente universais.

Segredos ficam em variáveis de ambiente, autenticação do provedor ou gerenciador de senhas. A skill descreve o processo, não armazena tokens.

Uma skill vale a pena quando a mesma instrução aparece em muitos prompts. Uma nota única fica no prompt; uma preferência permanente pertence à configuração ou documentação.

Se o resultado piorar, compare skill completa, versão curta e prompt normal. Isso separa conflito de instruções de falta de precisão.

Antes de separar regras de AGENTS.md em subagents, leia o guia OpenCode agents. guia OpenCode agents.