Verify OpenSpec docs: fresh-context fact-checking of documentation
Fact-checker la documentation OpenSpec terminée avec un sous-agent en contexte frais — ré-exécuter les commandes, valider les affirmations contre la source, lancer openspec validate sur les exemples, rapporter avec corrections en une ligne
- Quoi
- Fact-checker la documentation OpenSpec terminée avec un sous-agent en contexte frais — ré-exécuter les commandes, valider les affirmations contre la source, lancer openspec validate sur les exemples, rapporter avec corrections en une ligne
- Coût
- Gratuit
- Prérequis
- une arborescence de docs OpenSpec à vérifier et un agent capable de lancer des sous-agents — le skill est un workflow de vérification, pas un logiciel à installer
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — le skill de @fission-ai pour vérifier la documentation utilisateur OpenSpec terminée : une passe de vérification déclenchée manuellement (pas dans la boucle de rédaction — la rédaction appartient à write-openspec-docs, non fourni ici). La méthode : cadrer la passe sur une page, une section `##`, ou une liste d'affirmations modifiées ; lancer un sous-agent généraliste par unité avec chaque placeholder rempli et chaque chemin absolu. Le réviseur joue deux lecteurs à la fois — un développeur sceptique qui lit à froid et un fact-checker avec le repo ouvert — et vérifie, dans l'ordre : Faits (ré-exécuter chaque commande terminal montrée — commandes en lecture seule partout, commandes mutantes seulement dans un répertoire scratch ; vérifier les commandes de surface IA comme /opsx:propose contre les sources de skills ; chaque bloc de sortie doit correspondre à la sortie réelle), Exemples (tout spec d'exemple doit passer `openspec validate`), Structure (ne pas ré-expliquer les sujets appartenant à d'autres pages), Adéquation (l'unité sert-elle le job d'une ligne de la page ?), Confiance et remplissage (adjectifs hype, affirmations sans preuve, contrastes binaires, colon reveals, tirets cadratin, trois phrases percutantes d'affilée). Par défaut on rapporte, on ne réécrit pas : constats classés du plus grave au moins grave, chacun avec la ligne citée et une correction en une ligne, plus exactement ce qui a été vérifié et comment, et chaque affirmation non vérifiable et pourquoi. Corrections appliquées seulement sur approbation ; deux passes sans convergence = arrêt et escalade à l'utilisateur. Bémols honnêtes : conçu pour l'arborescence de docs du repo OpenSpec (les invariants du README de l'arbre et les règles de rédaction du repo font partie de ce qui est vérifié) ; l'agent doit pouvoir lancer des sous-agents. Licence MIT. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : une arborescence de docs OpenSpec à vérifier et un agent capable de lancer des sous-agents — le skill est un workflow de vérification, pas un logiciel à installer Installe-moi « Vérifier les docs OpenSpec : fact-checking de documentation en contexte frais ». Il enseigne à mon agent le workflow de vérification de docs de @fission-ai : cadrer la passe sur une page, section ou liste d'affirmations ; lancer un sous-agent en contexte frais par unité avec chemins absolus ; le réviseur ré-exécute les commandes terminal (lecture seule partout, mutantes seulement en scratch), lance openspec validate sur les specs d'exemple, et vérifie faits, exemples, structure, adéquation et confiance — puis rapporte les constats classés du plus grave au moins grave avec lignes citées, corrections en une ligne, exactement ce qui a été vérifié et comment, et chaque affirmation non vérifiable. Rapport seulement par défaut ; corrections appliquées uniquement sur approbation. Licence MIT. Dépôt : https://github.com/fission-ai/openspec/blob/main/.agents/skills/verify-openspec-docs/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « verify-openspec-docs ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. le lancer seulement quand tu veux une passe de vérification — la rédaction appartient au skill write-openspec-docs, non fourni ici ; remettre à l'agent la page ou section de docs à vérifier). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.