Guida OpenCode Skills: 7 regole per workflow IA riutilizzabili

Le OpenCode skills sono pacchetti di istruzioni riutilizzabili per attività di programmazione ripetute. Usale quando vuoi che OpenCode ricordi una procedura, una regola di dominio o uno standard di revisione. Non usarle come deposito di segreti o come sostituto di agents e MCP. Una skill ha senso quando la stessa istruzione ricorre in molti prompt. Una nota una tantum resta nel prompt; una preferenza permanente va in configurazione o documentazione.

Una skill ha senso quando la stessa istruzione ricorre in molti prompt. Una nota una tantum resta nel prompt; una preferenza permanente va in configurazione o documentazione.

Il test corretto è confrontare un'attività piccola con e senza skill. Se riduce spiegazioni ripetute e migliora il diff, resta.

Le skill di progetto sono più facili da revisionare perché vivono vicino al codice. Una skill globale può influenzare repository diversi, quindi usala solo per abitudini davvero universali.

Quando una skill cita framework, deployment, tono editoriale o compliance, di solito appartiene al progetto.

Una skill ha senso quando la stessa istruzione ricorre in molti prompt. Una nota una tantum resta nel prompt; una preferenza permanente va in configurazione o documentazione.

Una skill guida il comportamento; un command avvia un'azione nominata; un agent separa ruolo e contesto; MCP collega strumenti esterni.

Le skill di progetto sono più facili da revisionare perché vivono vicino al codice. Una skill globale può influenzare repository diversi, quindi usala solo per abitudini davvero universali.

Scrivi la skill come contratto verificabile: scopo, trigger, passi, limiti ed evidenza attesa. Se non è testabile, è troppo ampia.

Una skill ha senso quando la stessa istruzione ricorre in molti prompt. Una nota una tantum resta nel prompt; una preferenza permanente va in configurazione o documentazione.

Parti da un template minimo e sostituisci i segnaposto con comandi reali. Le skill piccole sono più facili da correggere.

---
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.

Le skill di progetto sono più facili da revisionare perché vivono vicino al codice. Una skill globale può influenzare repository diversi, quindi usala solo per abitudini davvero universali.

I segreti restano in variabili d'ambiente, login del provider o password manager. La skill descrive la gestione, non conserva token.

Una skill ha senso quando la stessa istruzione ricorre in molti prompt. Una nota una tantum resta nel prompt; una preferenza permanente va in configurazione o documentazione.

Se il risultato peggiora, confronta skill completa, versione breve e prompt normale. Così trovi sovrapposizioni e ambiguità.

Prima di separare regole AGENTS.md in subagents, consulta la guida OpenCode agents. guida OpenCode agents.