process-mapping — Claude Code skill: map workflows, find bottlenecks
A skill that walks the agent through documenting a current workflow, spotting bottlenecks and designing an improved version.
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a claude-codeWhat process-mapping does
The skill follows a mapping method: capture the current state (AS-IS) first, then design the future state (TO-BE). Four reference guides ship with it in the references/ directory — process documentation, current state analysis, future state design and improvement metrics. A table of approaches covers value stream mapping and swimlane diagrams with roles and responsibilities.
You answer the agent's questions about how the work happens today, who touches it and where it stalls. It turns those answers into a diagram with decision points and exceptions. One rule is stated plainly: document the real process, not the one the handbook describes. Otherwise the map is decoration.
The skill isn't tied to a language or stack, so it works for non-code business processes too. Install is one command, and the skill file lands at ~/.claude/skills/process-mapping/SKILL.md. Maps go stale — if the process changes often, you update them by hand, since nothing syncs them automatically.
What it helps with
- document a workflow so a new teammate can follow it
- spot bottlenecks and redundant approvals in a process
- design an improved process together with the people doing the work
- split a workflow by role and area of responsibility
- prepare material before rolling out a new system
Example prompts for the agent
- map our current client onboarding process and flag where it stalls
- draw a swimlane diagram for the contract approval workflow
- design the future ticket handling process and compare it to the current one
How to install process-mapping
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a claude-code2Manually: put the files in place
~/.claude/skills/process-mapping/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/process-mapping/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a codex2Manually: put the files in place
.agents/skills/process-mapping/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a cursor2Manually: put the files in place
.cursor/skills/process-mapping/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aj-geddes/useful-ai-prompts process-mapping2Manually: put the files in place
.github/skills/process-mapping/SKILL.md1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a gemini-cli2Platform CLI
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/process-mappingManually: put the files in place
.devin/skills/process-mapping/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about process-mapping
How do I install process-mapping in Claude?
Run npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a claude-code. The skill ends up at ~/.claude/skills/process-mapping/SKILL.md.
What does process-mapping do?
It guides the agent through documenting current and future processes, listing inefficiencies and dependencies. You get a process diagram plus a breakdown of improvement points.
Does the skill need any extra tooling?
No. It works through conversation with the agent and the guides in the references/ directory. Diagrams are built as text, with no external services.
Source text
SKILL.md · MIT
--- name: process-mapping description: > Visualize and document current and future business processes. Identify inefficiencies, dependencies, and improvement opportunities through detailed process mapping and analysis. --- # Process Mapping ## Table of Contents - [Overview](#overview) - [When to Use](#when-to-use) - [Quick Start](#quick-start) - [Reference Guides](#reference-guides) - [Best Practices](#best-practices) ## Overview Process mapping creates visual representations of workflows, helping teams understand current operations, identify bottlenecks, and design improvements. ## When to Use - Documenting existing workflows - Identifying process improvements - Onboarding new team members - Discovering inefficiencies and bottlenecks - Planning system implementations - Analyzing customer journeys - Automating manual processes - Training and documentation ## Quick Start Minimal working example: ```yaml Mapping Approaches: Current State (AS-IS): Purpose: Understand existing process Participants: People doing the work Timeline: 2-4 hours Output: Current workflow diagram Benefits: Identifies real bottlenecks Future State (TO-BE): Purpose: Design improved process Participants: Cross-functional team Timeline: 4-8 hours Output: Improved workflow design Benefits: Clear vision for change Value Stream Mapping: Purpose: Focus on value-added vs waste Participants: Process owners, operations Timeline: Full day Output: Detailed flow with timing Benefits: Identifies waste and delays Swimlane Diagram: Purpose: Show roles and responsibilities // ... (see reference guides for full implementation) ``` ## Reference Guides Detailed implementations in the `references/` directory: | Guide | Contents | |---|---| | [Process Documentation](references/process-documentation.md) | Process Documentation | | [Current State Analysis](references/current-state-analysis.md) | Current State Analysis | | [Future State Design](references/future-state-design.md) | Future State Design | | [Process Improvement Metrics](references/process-improvement-metrics.md) | Process Improvement Metrics | ## Best Practices ### ✅ DO - Map current state first before designing changes - Include all stakeholders in mapping sessions - Document actual processes, not theoretical ones - Identify waste and bottlenecks - Design future state with team input - Include decision points and exceptions - Add timing and resource information - Keep processes simple and visual - Update maps when processes change - Use mapping to drive continuous improvement ### ❌ DON'T - Skip documenting current state - Design future state without understanding current - Over-complicate process diagrams - Forget about edge cases and exceptions - Ignore process performance metrics - Create maps that nobody can understand - Design improvements without involving people doing work - Implement changes without validating process - Leave outdated maps in documentation - Ignore customer perspective
© aj-geddes · MIT · aj-geddes/useful-ai-prompts