Notre avis
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.
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.
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ûrThe 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é
Exemples
I need to change the title of Chapter 3 from 'Old Title' to 'New Title'. Please follow the edit-chapter workflow.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.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
- Read the entire chapter file
- Note the current H1 title (line 1)
- Note any template paths referenced (lines mentioning
templates/) - 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:
- Update
README.mdchapter listing (lines 45-93) - Update
CLAUDE.mdif the chapter is referenced there - Update the "Next:" link in the prior chapter's footer
If template references changed:
- Verify each referenced template path exists in
templates/ - If a path was removed or renamed, grep for the old path across the repo
If a canonical term changed:
- Search all
.mdfiles for the old term - Update every occurrence to match the new term
Always (every edit):
- Verify the chapter ends with a
Next:footer linking to the correct successor chapter, unless the file is11-failure-modes.md - The footer must follow this format:
--- Next: [Chapter NN -- Title](NN-slug.md)
If any structural change was made (title, file references, canonical terms):
- Run the
cross-reference-checkskill to verify consistency
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Recherche de Documentation Hono
Documentation
Utilisez le CLI hono pour rechercher et consulter la documentation du framework Hono. Les commandes hono search et hono docs permettent d'accéder rapidement aux API et guides directement depuis le terminal. Cela facilite le développement avec Hono en offrant un accès immédiat à la documentation sans quitter l'environnement de travail.