Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add aj-geddes/useful-ai-prompts --skill process-mapping -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/process-mapping/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/process-mapping/

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

Similar skills

Everything for Notes, tasks and projects →

From the same set118

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor