Skills Guide

Modifier un chapitre

VérifiéSûr

Workflow guidé pour éditer un chapitre du guide en toute sécurité, garantissant la propagation des changements structurels.

Télécharger et utiliser
Spar Skills Guide Bot
DocumentationIntermédiaire
23/07/2026
Claude Code
#guide-editing#chapter-workflow#structural-changes#cross-referencing#documentation-maintenance

Recommandé pour

Claude CodeDocumentation automatique

Synthèse automatique

Ce workflow guide l'édition de chapitres d'un guide technique en assurant la propagation des modifications structurelles à tous les fichiers dépendants.

Points forts

  • Vérifie systématiquement l'impact des changements de titre, de modèles et de termes canoniques.
  • Automatise les mises à jour croisées comme le README et les liens 'Suivant'.
  • Impose un style cohérent (voix prescriptive, sections requises, hiérarchie de titres).
  • Inclut une vérification finale avec le skill cross-reference-check.

Limites

  • Ne gère pas les modifications non structurelles (corrections mineures, reformulations).
  • Dépend de la présence d'un chapitre '11-failure-modes.md' pour la gestion des footers.
  • Requiert une exécution manuelle du skill cross-reference-check après les changements.
Quand l'utiliser

Utilisez ce workflow avant toute modification substantielle d'un fichier dans le dossier guide/, notamment pour changer un titre, une référence de template ou un terme canonique.

Quand l'éviter

Ne l'utilisez pas pour des corrections mineures (fautes de frappe, ajustements de style) qui n'affectent pas la structure du guide.

Analyse de sécurité

Sûr
Score qualité95/100

The skill outlines a workflow for editing guide chapters, ensuring consistency across files. It only instructs reading, searching, and updating markdown files, with no destructive or exfiltration actions. No risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Change chapter title
I need to change the title of Chapter 3 from 'Old Title' to 'New Title'. Please follow the edit-chapter workflow.
Update template reference
In chapter 5, I'm replacing the template path 'templates/old.md' with 'templates/new.md'. Run the edit-chapter workflow to ensure all dependencies are updated.
Modify canonical term
I'm changing the canonical term 'five-tier context hierarchy' to 'four-tier context hierarchy' across the guide. Use edit-chapter to update all occurrences.

name: edit-chapter description: Invoke this skill before making substantive edits to any file in guide/ — changing content, titles, template references, or canonical terms. Follow this workflow proactively when editing chapters, not only when the user explicitly requests it. Ensures structural changes propagate to all dependent files.

Edit Chapter

Guided workflow for safely editing a guide chapter. Ensures structural changes propagate to all dependent files.

Before Editing

  1. Read the entire chapter file
  2. Note the current H1 title (line 1)
  3. Note any template paths referenced (lines mentioning templates/)
  4. Note any canonical terms used ("five-tier context hierarchy", "document cascade")

During Editing

  • Maintain prescriptive voice — no hedging phrases (see .claude/rules/guide-chapter.md)
  • Preserve required sections: Principles, What the Human Should Do, What the Agent Should Do
  • Use RecipeVault for examples (not "Beacon")
  • Keep heading hierarchy: ## for major sections, ### for subsections
  • Use fenced code blocks with language identifiers

After Editing

Check each condition and take action if true:

If the H1 title changed:

  1. Update README.md chapter listing (lines 45-93)
  2. Update CLAUDE.md if the chapter is referenced there
  3. Update the "Next:" link in the prior chapter's footer

If template references changed:

  1. Verify each referenced template path exists in templates/
  2. If a path was removed or renamed, grep for the old path across the repo

If a canonical term changed:

  1. Search all .md files for the old term
  2. Update every occurrence to match the new term

Always (every edit):

  1. Verify the chapter ends with a Next: footer linking to the correct successor chapter, unless the file is 11-failure-modes.md
  2. The footer must follow this format: 
    ---

Next: [Chapter NN -- Title](NN-slug.md)

If any structural change was made (title, file references, canonical terms):

  1. Run the cross-reference-check skill to verify consistency

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 annexes

Ce 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.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/edit-chapter-mrwak9gg/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/edit-chapter-mrwak9gg' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/edit-chapter-mrwak9gg/download' --output '.skill-downloads/edit-chapter-mrwak9gg/SKILL.md.part' && mv '.skill-downloads/edit-chapter-mrwak9gg/SKILL.md.part' '.skill-downloads/edit-chapter-mrwak9gg/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/edit-chapter-mrwak9gg/SKILL.md' && test -s '.skill-downloads/edit-chapter-mrwak9gg/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/edit-chapter' && cp -R '.skill-downloads/edit-chapter-mrwak9gg' '.claude/skills/edit-chapter'

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’OpenSkills
openskills install './.skill-downloads/edit-chapter-mrwak9gg'

openskills read 'edit-chapter-mrwak9gg'

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 sync

Mode 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/edit-chapter-mrwak9gg/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.

Skills similaires

Rédaction de docs Supabase

Documentation

Rédigez, éditez et révisez le contenu de la documentation Supabase : guides, tutoriels, références et partiels. Suivez les guides de style et les règles de validation MDX/TOML.

Claude CodeintermediateSûr 108,544
Skills Guide Bot

Créer un enregistrement de décision d'architecture

Documentation

Créer un nouveau ADR avec numérotation séquentielle, l'enregistrer dans le graphe AgentDB et le lier aux ADR associés.

Claude CodeintermediateSûr 69,659
Skills Guide Bot

Mise à jour de plan avec recherche approfondie

Documentation

Met à jour un document de plan en lançant des sous-agents en parallèle pour analyser un sujet sur tous les passes du compilateur, puis consolide les résultats.

Claude CodeadvancedSûr 248,015
Skills Guide Bot