Is this useful for API documentation?

Absolutely. It integrates with openapi-design to help document the various states an API resource can inhabit during its lifecycle.

Does it support complex state hierarchies?

Yes, it can model initial states, normal states, final states, composite (nested) states, and history states.

How does it handle business rules and constraints?

It identifies business rules as 'guards' (conditions that must be met for a transition) and 'actions' (side effects that occur during transitions).

Can this skill generate actual programming code?

Yes, it can generate implementation code for C# using the Stateless library and TypeScript using the XState framework.

What diagram formats are supported by this skill?

The skill supports PlantUML for detailed technical documentation, Mermaid for inline markdown visualization, and XState for creating executable state machine definitions.

State Machine Modeling

Name: State Machine Modeling
Author: melodic-software

bymelodic-software

•

API Development

Generates visual state machine diagrams and executable implementation code from natural language behavior descriptions.

This skill bridges the gap between behavioral requirements and formal technical specifications by transforming text descriptions into precise state machine diagrams. It supports industry-standard formats like PlantUML, Mermaid, and XState, while providing optional implementation code for C# and TypeScript. Ideal for software architects and developers, it ensures system lifecycles—such as order processing or user verification—are accurately modeled, documented, and ready for implementation with guards, actions, and clear transition logic.

Key Features

01Support for complex state types including composite and history states

02Seamless integration with API design and requirement elicitation workflows

0338 GitHub stars

04Automated extraction of states, events, guards, and actions

05Production-ready C# (Stateless) and TypeScript (XState) code generation

06Multi-format diagram generation including PlantUML, Mermaid, and XState

Use Cases

01Modeling complex e-commerce order lifecycles from creation to delivery

02Generating executable state machine logic for user account verification and suspension

03Designing multi-stage document approval workflows with review and revision cycles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins state-diagram

For use in Claude.ai and ChatGPT

Download Skill