Agent skill
flow
Documents workflow diagrams and process flows with Mermaid diagram support.
Install this agent skill to your Project
npx add-skill https://github.com/goffity/claude-km-skill/tree/main/skills/flow
SKILL.md
Flow - Process Flow Documentation
Document workflows, sequences, and state machines with Mermaid diagrams.
Usage
/flow [name]
/flow pr-review
/flow deployment
Output: $PROJECT_ROOT/docs/flows/[name].md
Instructions
- Parse name → kebab-case filename
- Ask user about the flow:
- What type? (process/sequence/state)
- What actors/components are involved?
- What are the main steps?
- Generate flow document with Mermaid diagram
- Save to
docs/flows/[name].md
Template
# [Flow Name]
| Field | Value |
|-------|-------|
| Type | Process / Sequence / State |
| Actors | [list of actors] |
| Created | YYYY-MM-DD |
## Overview
> One sentence description of what this flow does.
## Diagram
```mermaid
sequenceDiagram
participant A as Actor1
participant B as Actor2
A->>B: Action
B-->>A: Response
Steps
- Step 1: Description
- Step 2: Description
- Step 3: Description
Error Handling
| Error | Handling |
|---|---|
| [error case] | [how to handle] |
Related
- [related flows or docs]
## Diagram Types
### Sequence Diagram
```mermaid
sequenceDiagram
participant U as User
participant S as System
U->>S: Request
S-->>U: Response
Flowchart
flowchart TD
A[Start] --> B{Decision}
B -->|Yes| C[Action]
B -->|No| D[Other]
State Diagram
stateDiagram-v2
[*] --> Idle
Idle --> Processing: start
Processing --> Done: complete
Processing --> Error: fail
Related Commands
| Command | Purpose |
|---|---|
/mem |
Capture insights about flows |
/flow |
Document flows (you are here) |
/pattern |
Document reusable patterns |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
goffity/claude-km-skill
commit
Creates atomic commits by invoking TDG and commenting on related GitHub issues.
goffity/claude-km-skill
distill
Synthesizes related learnings into reusable knowledge base patterns.
goffity/claude-km-skill
security-auditor
Audits code for security vulnerabilities including OWASP Top 10 and authentication issues.
goffity/claude-km-skill
code-reviewer
Reviews code changes for bugs, security vulnerabilities, and performance issues.
goffity/claude-km-skill
example
Saves reusable code examples to the examples library with metadata and tags.
goffity/claude-km-skill
share
Shares knowledge across projects by copying to shared-knowledge directory with cross-project metadata.
Didn't find tool you were looking for?