Skill To-Spec
Consignez les décisions approuvées en spécification puis publiez-la dans le suivi configuré.
Communauté · Matt Pocock| Auteur | Matt Pocock |
|---|---|
| Licence | MIT |
| Source | mattpocock/skills · SKILL.md sur GitHub |
| Site du projet | www.aihero.dev/skills-to-spec |
| Fonctionne dans | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lu à la source le |
to-spec synthétise une conversation déjà décidée en spécification. Il s’appuie sur code, glossaire et décisions d’architecture sans recommencer l’entretien des besoins.
Il confirme les points de test, consigne récits et périmètre, puis publie une spécification dans le suivi configuré. Markdown est possible avec la configuration locale.
Extrait du SKILL.md du skill : ## Out of Scope
Ce qu’il fait
- Lisez la conversation et les décisions pertinentes.
- Confirmez les points de test et synthétisez la spécification.
- Publiez dans le suivi avec l’étiquette de tri configurée.
Ce que vous obtenez
- Spécification couvrant problème, solution, récits, décisions, tests et exclusions.
Quand l’utiliser
- Conserver les décisions pour un travail sur plusieurs sessions.
Quand ne pas l’utiliser
- Besoins non décidés ou petit changement réalisable en une session.
Ce qu’il faut
- Agent avec contexte projet et configuration du suivi via setup-matt-pocock-skills.
- Un suivi distant exige outils authentifiés et droit de publication ; Markdown local évite le service distant.
Fichiers du skill
| Fichier ou dossier | À quoi il sert |
|---|---|
SKILL.md | Modèle de spécification, confirmation des tests et publication. |
Licence trouvée dans le dépôt le 2026-11-19 : MIT.
Exemples de prompts
Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.
- /to-spec — synthétisez notre export de compte approuvé sans inventer de besoins.
- /to-spec — conservez nos exclusions et confirmez d’abord les points de test.
- /to-spec #42 — transformez cette carte de décisions en spécification réalisable.
Comment installer to-spec
Installation et autorisations
Installez et configurez suivi et étiquettes via setup-matt-pocock-skills. Relisez toute configuration créée avant usage.
Invocation manuelle : disable-model-invocation vaut true. Confirmez destination et autorisations ; ce site ne crée pas de tickets.
Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :
Claude Code : copier le dossier dans votre dossier de skills
Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/Claude Code détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /to-spec ou décrivez simplement la tâche.
Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.
Codex, Gemini CLI, Cursor et GitHub Copilot
Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le skill :
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/| Agent | Dossier du projet | Votre dossier utilisateur | Remarques |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure). |
Sources de ces étapes
Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :
Consigner les décisions déjà prises
Gardez le vocabulaire du projet et ses vraies exclusions. N’inventez pas de décisions pour remplir des rubriques.
Pour plusieurs sessions, transmettez à to-tickets. Garder les deux étapes dans le même contexte évite de récupérer un ticket très long.
Questions sur to-spec
Va-t-il m’interroger ?
Pas de nouvel entretien de besoins, mais il vérifie les points de test avec vos attentes.
GitHub est-il obligatoire ?
Non. Le suivi configuré peut être du Markdown local ou un service distant pris en charge.
to-prd est-il la même commande ?
L’auteur l’a renommée to-spec. Utilisez le nom installé actuel.
ready-for-agent peut-il déclencher du travail indésirable ?
Oui. Un agent de surveillance peut sélectionner la spécification parent comme tâche. Excluez-la explicitement de sa sélection.
Plus de skills IA
Skills similaires
Skill To-Tickets
Communauté · Matt PocockDécoupez une spécification en tranches verticales démontrables avec blocages explicites.Skill Writing Plans
Communauté · Jesse Vincent / Prime RadiantTransformez une conception approuvée en tâches vérifiables, avec interfaces et contrôles.Skill Brainstorming
Communauté · Jesse Vincent / Prime RadiantTransformez une idée initiale en conception approuvée avant de coder.Skill Subagent-Driven Development
Communauté · Jesse Vincent / Prime RadiantExécutez un plan approuvé avec nouveaux réalisateurs, revues ciblées et journal des tâches.n8n auto-hébergé skill
Communauté · Romuald CzłonkowskiDéployez et maintenez n8n avec Docker, HTTPS Caddy, services privés et sauvegardes vérifiées.n8n Code JavaScript skill
Communauté · Romuald CzłonkowskiÉcrivez ou déboguez JavaScript dans n8n selon les modes d’entrée et de retour.