CoFabNum Agent Skills

Skills pour agents (OpenCode, Claude, Codex) basés sur la documentation de la Fabrique Numérique.

Structure

.agents/skills/
├── conventions-cofabnum/ → nommage, architecture, TypeScript, API, lint, code qualité, déploiement, POC→prod
├── recettes-serveur/ → NestJS, Fastify, FastAPI
├── recettes-client/ → Vue 3, Nuxt 3, Toaster
├── stack-technique/ → ESLint, Prisma, Prettier, REST Client
├── monorepo/ → pnpm workspaces, Turborepo
├── ci-cd/ → GitHub Actions, workflows réutilisables, Trivy, SonarQube
├── environnement-installation/ → Windows/WSL, macOS, Ubuntu
└── outils-dev/ → Git, Docker, pnpm, proto, VS Code, GitHub CLI, zsh

Installation

Les skills sont dans .agents/skills/ — standard cross-client reconnu par OpenCode, Claude Code, Codex, etc.

Depuis ce repo

# Copier tous les skills dans le dossier global
cp -r .agents/skills/*~/.agents/skills/

Depuis un autre projet

Le dossier ~/.agents/skills/ est automatiquement scanné par tous les clients compatibles.

Installation via opencode.json

Ajouter ce dossier comme dépôt Git pour que les skills soient découverts automatiquement via .agents/skills/.

Scripts disponibles

Chaque skill peut contenir des scripts dans scripts/ :

Script	Skill	Usage
check-environment.sh	outils-dev	Vérifie les outils installés
validate-branch.sh	conventions	Valide le format <type>/<kebab>#<ticket>
check-folders.sh	conventions	Vérifie kebab-case et PascalCase
scaffold-nestjs.sh	recettes-serveur	Crée un projet NestJS complet
scaffold-fastify.sh	recettes-serveur	Crée un projet Fastify complet
scaffold-fastapi.sh	recettes-serveur	Crée un projet FastAPI complet

Sécurité

Les permissions sont configurées dans opencode.json — par défaut permissives :

• Skills : tous chargés automatiquement ("*": "allow")
• bash, edit, read : valeurs par défaut OpenCode (allow sauf .env)

Source

Ces skills sont dérivés de la documentation officielle de la Fabrique Numérique (dnum-mi/transversal-doc).

Références

Standard Agent Skills

• Specification — format SKILL.md, frontmatter, conventions de nommage
• Best Practices — scopes, contexte, calibrage
• Using Scripts — scripts, agentskills.io, output structuré
• Client Implementation — progressive disclosure, permissions

OpenCode

• Skills Documentation — discovery, placement, format
• Permissions — rules granulaires, allow/deny/ask

Fabrique Numérique

• docs.fabrique-numerique.fr — documentation officielle
• GitHub: dnum-mi/transversal-doc — repo source
• GitHub: dnum-mi/fabnum-cicd — workflows CI/CD réutilisables