Skip to content
Skills Library
Programming · Analysis

workflow-analysis

/workflow-analysis

Analyze, visualize, and inspect Flowcraft workflows. Covers static analysis (analyzeBlueprint, lintBlueprint, checkForCycles), Mermaid diagram generation, UI graph representation, and the CLI tool. Use when validating blueprints, generating diagrams, detecting cycles, or inspecting workflow executions.

Repository
flowcraft ↗
Licence
MIT
Last repository change
02.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Analyze, visualize, and inspect Flowcraft workflows. Covers static analysis (analyzeBlueprint, lintBlueprint, checkForCycles), Mermaid diagram generation, UI graph representation, and the CLI tool. Use when validating blueprints, generating diagrams, detecting cycles, or inspecting workflow executions.

Original author description

Analyze, visualize, and inspect Flowcraft workflows. Covers static analysis (analyzeBlueprint, lintBlueprint, checkForCycles), Mermaid diagram generation, UI graph representation, and the CLI tool. Use when validating blueprints, generating diagrams, detecting cycles, or inspecting workflow executions.

How it works

  1. Tools Overview
  2. Quick Examples
  3. When to Use
Original SKILL.md headings · 70 lines, 226 words
SKILL.md preview
---
name: workflow-analysis
description: Analyze, visualize, and inspect Flowcraft workflows. Covers static analysis (analyzeBlueprint, lintBlueprint, checkForCycles), Mermaid diagram generation, UI graph representation, and the CLI tool. Use when validating blueprints, generating diagrams, detecting cycles, or inspecting workflow executions.
---

# Workflow Analysis

Flowcraft provides tools to statically analyze, visualize, and inspect workflows before and after execution.

## Tools Overview

| Tool                | Purpose                                                       | See                                      |
| ------------------- | ------------------------------------------------------------- | ---------------------------------------- |
| **Static Analysis** | Detect cycles, validate blueprints, find start/terminal nodes | [static-analysis.md](static-analysis.md) |
| **Visualization**   | Generate Mermaid diagrams, UI-friendly graph representations  | [visualization.md](visualization.md)     |
| **CLI**             | Inspect workflow executions from SQLite/PostgreSQL history    | [cli.md](cli.md)                         |

## Quick Examples

### Analyze a Blueprint

```typescript
import { analyzeBlueprint, createFlow } from 'flowcraft'

const flow = createFlow('my-flow')
	.node('A', async () => ({}))
	.node('B', async () => ({}))
	.edge('A', 'B')
	.toBlueprint()

const analysis = analyzeBlueprint(flow)
// {
//   cycles: [],
//   startNodeIds: ['A'],
//   terminalNodeIds: ['B'],
//   nodeCount: 2,
//   edgeCount: 1,
//   isDag: true
// }
```

### Generate a Diagram

```typescript
import { generateMermaid } from 'flowcraft'

const mermaidSyntax = generateMermaid(blueprint)
console.log(mermaidSyntax)
// flowchart TD
//   A["A"]
//   B["B"]
//   A --> B
```

### Lint a Blueprint

```typescript
import { lintBlueprint } from 'flowcraft'

const result = lintBlueprint(blueprint, registry)
if (!result.isValid) {
	for (const issue of result.issues) {
		console.log(`${issue.nodeId}: ${issue.message}`)
	}
}
```

## When to Use

- **Before running**: `lintBlueprint()` to catch structural issues
- **Debugging**: `generateMermaidForRun()` to see execution path with highlighting
- **CI/CD**: `analyzeBlueprint()` to enforce DAG constraints
- **Post-mortem**: `flowcraft inspect <run_id>` to examine completed executions
Files in this package (4)
  • SKILL.md 2 KB
  • cli.md 4 KB
  • static-analysis.md 4 KB
  • visualization.md 4 KB

Versions

The database has no other skills named workflow-analysis.

Database snapshot: 13.11.2026 · package version 96e7a526b7e0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100debugging-workflows
    Test, debug, and troubleshoot Flowcraft workflow executions. Covers test utilities, time-travel debugging, event analysis, and common error patterns. Use when debugging workflows, writing tests, analyzing execution events, replaying workflow runs, or troubleshooting workflow failures.
  • 100building-workflows
    Build and execute workflows using Flowcraft's fluent API or declarative JSON blueprints. Covers nodes, edges, context, branching, error handling, and runtime execution. Use when creating workflows, defining workflow steps, connecting nodes, managing workflow state, or when the…
  • 90doncheli-diagram
    Auto-generate Mermaid or C4 diagrams from code analysis. Activate when user mentions "diagram", "mermaid", "architecture diagram", "C4", "class diagram", "sequence diagram", "ERD", "flowchart", "visualize code".
  • 90mermaid-diagram-generator
    Use when users need Mermaid diagrams for Arduino code structure, state machines, timing diagrams, task architecture, or workflow documentation.
  • 100mermaid-diagramming
    Create Mermaid diagrams using the project's blue-gray theme. Use whenever the user asks to draw a diagram, create a flowchart, visualize a process, document architecture, or add any Mermaid diagram to a markdown file. Trigger on phrases like "draw a diagram", "create a…
  • 100mermaid-diagrams
    Create or fix Mermaid diagrams in Markdown. Use for requested flowcharts, sequence diagrams, ER diagrams, state machines, or system diagrams when Mermaid is the output format; not every visualization or explanation.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.