Aller au contenu

Skill To-Spec

Consignez les décisions approuvées en spécification puis publiez-la dans le suivi configuré.

Communauté · Matt Pocock
AuteurMatt Pocock
LicenceMIT
Sourcemattpocock/skills · SKILL.md sur GitHub
Site du projetwww.aihero.dev/skills-to-spec
Fonctionne dansClaude 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

Ceci est un skill de la communauté créé par Matt Pocock, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Lisez la conversation et les décisions pertinentes.
  2. Confirmez les points de test et synthétisez la spécification.
  3. 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.mdModè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/
AgentDossier du projetVotre dossier utilisateurRemarques
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).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

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

Catégories de skills