diagram-update

Regenerate a self-contained interactive HTML diagram of the plugin's skills, hooks, and workflow edges.

Updated May 26, 2026
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill diagram-update-cagriy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-update
Source: https://github.com/cagriy/dev-skills/tree/main/skills/diagram-update
Command: npx skills add https://github.com/cagriy/dev-skills --skill diagram-update-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a plugin's skills, hooks, and scripts change over time, hand-maintained architecture diagrams drift out of sync with reality. This Skill rebuilds the workflow diagram from the files on disk every run, so the documentation always reflects what the plugin actually ships. ## Core Features & Use Cases - Full inventory and re-derivation: Reads every SKILL.md, hook config, and script in the repo, extracting steps, approval gates, loop-backs, parallelism, and cross-skill edges from source rather than memory. - Template-driven rendering: Substitutes per-run data (groups, skills, edges, overview layout) into templates/workflow-diagram.html, which owns all presentation, and writes the result wholesale to diagram/index.html. - Safety gates and verification: Confirms before running when invoked proactively, refuses to run outside the dev-skills plugin repo, and statically verifies the output (no leftover tokens, every skill present, no external URLs). - Use Case: After adding a new skill to the dev-skills plugin, run the diagram regeneration to publish an updated interactive workflow page showing the new skill's steps, gates, and chain edges without editing any HTML by hand. ## Quick Start Ask the assistant to regenerate the plugin workflow diagram from the current skills and hooks on disk.

Frequently Asked Questions about diagram-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I regenerate the plugin workflow diagram?

Invoke /diagram-update inside the dev-skills plugin repo. The skill inventories all skills and hooks, derives the graph data, renders it from templates/workflow-diagram.html, and overwrites diagram/index.html wholesale.

How do I update an architecture diagram after adding a new skill?

Just re-run the diagram regeneration; nothing needs editing by hand. The skill re-derives groups, steps, and edges from whatever files are on disk, so a skill added yesterday appears automatically in the output.

Can I run this diagram generator outside the dev-skills repo?

No. The skill checks the plugin manifest and refuses to run unless .claude-plugin/plugin.json has the name "dev". It also stops if templates/workflow-diagram.html is missing rather than authoring the page by hand.

Should I hand-edit the generated diagram/index.html?

No. The file is a generated artefact overwritten wholesale on every run, so manual edits are lost. Presentation changes belong in templates/workflow-diagram.html, followed by a regeneration run.

Does the diagram update skill commit or push changes?

No. Its only write is diagram/index.html in the working tree, and it never commits or pushes. It is read-only toward skills, hooks, templates, and everything else in the repository.