Guide OpenCode Skills : 7 règles pour des workflows IA réutilisables

Réponse rapide

OpenCode Skills

Les skills OpenCode sont des paquets d'instructions réutilisables pour le travail de programmation qui revient souvent. Utilisez-les pour mémoriser une procédure, une règle de domaine ou un standard de revue. Ne les utilisez pas comme coffre à secrets ni comme remplacement d'un agent ou d'un serveur MCP. Une skill mérite d'exister quand la même consigne revient dans de nombreux prompts. Pour une note ponctuelle, gardez-la dans le prompt; pour une préférence permanente, documentez-la dans la configuration.

1. Utiliser une skill seulement si le flux se répète

Une skill mérite d'exister quand la même consigne revient dans de nombreux prompts. Pour une note ponctuelle, gardez-la dans le prompt; pour une préférence permanente, documentez-la dans la configuration.

Le bon test consiste à comparer une petite tâche avec et sans la skill. Si elle réduit les explications répétées et améliore le diff, elle vaut la peine.

2. Choisir la portée avant d'écrire

Les skills de projet sont plus faciles à relire car elles vivent près du code concerné. Une skill globale peut influencer d'autres dépôts; réservez-la aux habitudes vraiment universelles.

Dès qu'une skill mentionne un framework, un déploiement, une voix éditoriale ou une règle de conformité, elle devrait généralement rester au niveau du projet.

3. Skills, commands, agents et MCP

Une skill mérite d'exister quand la même consigne revient dans de nombreux prompts. Pour une note ponctuelle, gardez-la dans le prompt; pour une préférence permanente, documentez-la dans la configuration.

Une skill guide le comportement, une command lance une action nommée, un agent sépare rôle et contexte, MCP connecte des outils externes.

Besoin	Utiliser	Éviter
Checklist répétée	Skill	Copier le même prompt
Action nommée	Command	Processus caché
Rôle séparé	Agent	Skill géante
Service externe	MCP	Secrets dans la skill
Règles de dépôt	Skill projet	Skill globale surprenante

4. Écrire de petits contrats

Les skills de projet sont plus faciles à relire car elles vivent près du code concerné. Une skill globale peut influencer d'autres dépôts; réservez-la aux habitudes vraiment universelles.

Rédigez la skill comme un contrat relisible : objectif, déclencheur, étapes, limites et preuve attendue. Une skill impossible à tester est trop large.

5. Modèle pratique

Une skill mérite d'exister quand la même consigne revient dans de nombreux prompts. Pour une note ponctuelle, gardez-la dans le prompt; pour une préférence permanente, documentez-la dans la configuration.

Commencez par un modèle minimal et remplacez les placeholders par les vraies commandes du dépôt. Une petite skill coûte moins cher à corriger.

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

6. Séparer secrets et permissions

Les skills de projet sont plus faciles à relire car elles vivent près du code concerné. Une skill globale peut influencer d'autres dépôts; réservez-la aux habitudes vraiment universelles.

Les secrets doivent rester dans les variables d'environnement, l'authentification du fournisseur ou un gestionnaire dédié, jamais dans la skill.

7. Réduire la portée au dépannage

Une skill mérite d'exister quand la même consigne revient dans de nombreux prompts. Pour une note ponctuelle, gardez-la dans le prompt; pour une préférence permanente, documentez-la dans la configuration.

Si le résultat se dégrade, comparez la skill complète, une version courte et un prompt normal. Cela isole les conflits d'instructions.

Questions fréquentes

Qu'est-ce qu'une skill OpenCode ?

Un paquet d'instructions réutilisable pour un flux, une règle ou un standard précis.

Skill ou agent ?

Skill pour guider le flux actuel; agent pour rôle, outils ou contexte séparé.

Où placer les skills de projet ?

Avec le projet afin que l'équipe puisse les relire et les versionner.

Une skill exécute-t-elle des commandes ?

Elle peut indiquer les validations importantes, mais l'exécution doit rester explicite.

Combien de skills créer ?

Commencez avec une ou deux à forte valeur, puis ajoutez seulement ce qui améliore les tâches répétées.

Guide agents associé

Avant de séparer les règles AGENTS.md en subagents, consultez le guide OpenCode agents. guide OpenCode agents.

Sources

Documentation officielle vérifiée le 2026-07-14; les commandes et chemins peuvent changer avec les versions d'OpenCode.