generate-state-diagram

Analyze codebases to generate Mermaid state diagrams from status fields and transitions.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/vndkubi/code-graph --skill generate-state-diagram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-state-diagram
Source: https://github.com/vndkubi/code-graph/tree/main/.github/skills/generate-state-diagram
Command: npx skills add https://github.com/vndkubi/code-graph --skill generate-state-diagram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates clear Mermaid state diagrams from code by extracting entity lifecycles and transitions, reducing manual diagramming effort.

Core Features & Use Cases

  • Auto-detects status/state fields across languages (Java, Python, TypeScript, etc.)
  • Produces Mermaid diagrams reflecting current and proposed states for documentation and reviews
  • Helps validate state coverage and transition completeness in codebases

Quick Start

Analyze your codebase to generate a Mermaid state diagram that visualizes an entity's lifecycle and transitions.

Frequently Asked Questions about generate-state-diagram

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

FAQPage Schema
How do I generate a Mermaid state diagram from code?

Auto-detect status and state fields across Java, Python, and TypeScript codebases to map transitions and produce Mermaid state diagrams reflecting current and proposed states for documentation.

Can I visualize entity lifecycles for multiple programming languages?

Yes, visualize entity lifecycles across languages like Java, Python, and TypeScript by detecting status/state fields and enum definitions to trace transitions into visual diagrams.

What is the best way to trace state transitions in an existing codebase?

Trace state transitions by parsing enum and state definitions across your codebase, mapping FROM/TO transitions, and generating Mermaid diagrams with code locations and validation notes.

Does this state diagram generation approach work with Python and TypeScript enums?

Yes, state diagram generation works with Python and TypeScript by detecting enum-like definitions and status fields to map transitions and output Mermaid diagrams for code reviews.

How do I validate state coverage and transition completeness in my code?

Validate state coverage and transition completeness by generating Mermaid state diagrams that visualize entity lifecycles, parse state definitions, and output validation notes for your codebase.

Are there limitations when auto-detecting state fields across different frameworks?

Auto-detecting state fields applies across languages and frameworks by finding status fields and enum definitions, but complex dynamic transitions may require manual validation using the outputted Mermaid diagrams.