Synthèse automatique
Référence qui documente la personnalisation d'OpenCode (sst/opencode) dans les projets gald3r : arborescence .opencode/, fichier opencode.json, découverte native des skills, instructions AGENTS.md/CLAUDE.md, plugins JS/TS, MCP et vérification de l'installation.
Points forts
- Couvre précisément les hooks natifs du cycle de vie via des plugins JS/TS dans .opencode/plugins/ (20 événements, dont tool.execute.before/after et session.created)
- Explique la découverte des Agent Skills dans trois répertoires (.opencode/skills, .claude/skills, .agents/skills)
- Détaille la configuration MCP locale et distante avec substitution {env:}/{file:} dans opencode.json
- Inclut des métadonnées de fraîcheur (crawl_max_age_days, last_doc_scan) et un contrat d'aide qui évite toute écriture d'état sur -h/--help
Limites
- Spécifique à OpenCode uniquement : les skills Python g-hk-*.py de gald3r nécessitent un shim JS/TS et il n'existe pas d'événement git pre-commit de premier ordre
- Pas de moteur de règles à portée de glob comparable au .mdc, ce qui limite le ciblage conditionnel des instructions
- La validité dépend de la date de scan des docs et impose un recrawl périodique
À utiliser pour configurer ou vérifier OpenCode dans un projet gald3r : rédiger opencode.json, des plugins, AGENTS.md ou des serveurs MCP.
À éviter pour d'autres plateformes (Claude Code, Cursor) ou pour des tâches de code sans rapport avec la personnalisation d'OpenCode.
Analyse de sécurité
SûrThe file is purely a documentation-style reference for OpenCode configuration. It contains no executable instructions, no destructive commands, no secret/credential handling, no obfuscation, and no attempt to disable safety controls. The only 'code-like' elements (`!bash` frontmatter, JS/TS plugin hooks) are described as features of the target platform rather than actions the agent is told to run. With no declared tools and no operational body, the listing risk is minimal.
- •References external documentation URLs (opencode.ai/docs) but only as pointers, not fetched/executed by the skill
- •Mentions OpenCode's `!bash` command frontmatter feature descriptively — no actual shell command is instructed
- •No declared allowed-tools and no executable payload; content is a documentation/reference index
Exemples
Add a local MCP server to my opencode.json that reads the GitHub token from {env:GITHUB_TOKEN} and explain how remote servers are configured.Where does OpenCode look for SKILL.md files, and will it pick up the skills already in my .claude/skills directory?Write a .opencode/plugins/ JS plugin that hooks tool.execute.before to log every shell command before it runs.name: g-skl-platform-opencode description: Authoritative reference for OpenCode (sst/opencode) customization in gald3r projects. Covers .opencode/ folder layout, opencode.json config, native skills discovery (.opencode/skills/ + .claude/skills/ + .agents/skills/), AGENTS.md/CLAUDE.md instructions, JS/TS plugin hooks, MCP, and gald3r install verification. crawl_max_age_days: 7 vault_doc_path: research/platforms/opencode/ vault_docs_url: https://opencode.ai/docs docs_url: https://opencode.ai/docs docs_url_secondary:
- https://opencode.ai/docs/plugins/
- https://opencode.ai/docs/agents/
- https://opencode.ai/docs/skills/
- https://opencode.ai/docs/commands/
- https://opencode.ai/docs/rules/
- https://opencode.ai/docs/mcp-servers/ last_doc_scan: 2026-06-02 capability_status: hooks: "✅ native lifecycle hooks via JS/TS plugins in .opencode/plugins/ (20 events incl. tool.execute.before/after, session.created, file.edited); gald3r g-hk-.py (python <path>) need a JS/TS shim; no first-class git pre-commit event" rules: "✅ AGENTS.md primary (CLAUDE.md fallback; AGENTS.md wins if both local) + opencode.json instructions array; no .mdc glob-scoped rule engine" skills: "✅ Agent Skills (SKILL.md) loaded on-demand via native skill tool; discovered in .opencode/skills / .claude/skills / .agents/skills" commands: "✅ custom commands .opencode/commands/.md ($ARGUMENTS/$1 + !bash; frontmatter description/agent/model/subtask)" agents: "✅ native primary agents (Build/Plan) + subagents (General/Explore/Scout) in .opencode/agents/ or opencode.json; @mention + Task tool" mcp: "✅ native — mcp field in opencode.json (local + remote), {env:}/{file:} substitution" token_budget: low subsystem_memberships: [PLATFORM_INTEGRATION]
HELP CONTRACT (T442 — cross-platform, non-substitutable)
If the invoking command's arguments are EXACTLY -h, --help, or help (one
token, nothing else): do NOT run any operation of this skill. Respond ONLY with a
compact usage card — the command's name, its one-line purpose, each documented
argument/option on its own line (or "none"), and the path to its command file —
then STOP. Read-only: no .gald3r/ writes, no state changes, no task/bug
creation. This block lives in the SKILL (not a rule) because skills are the
execution layer on every supported platform; rules are optional context on most.
Provisioned by gald3r platform install.
Documentation: https://docs.gald3r.ai
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/opencode-platform-customization-msfn1a3a' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/opencode-platform-customization-msfn1a3a/download' --output '.skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md.part' && mv '.skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md.part' '.skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md' && test -s '.skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/g-skl-platform-opencode' && cp -R '.skill-downloads/opencode-platform-customization-msfn1a3a' '.claude/skills/g-skl-platform-opencode'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/opencode-platform-customization-msfn1a3a'openskills read 'opencode-platform-customization-msfn1a3a'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/opencode-platform-customization-msfn1a3a/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.