skills/by-role/business-analyst/process-mapper/SKILL.md
Map business processes as-is and to-be. Use when the user says "map the process", "draw the workflow", "BPMN diagram", "process flow", "swimlane", "how does this process work", "document the current process", "redesign this process", "process improvement", "value stream map", "workflow analysis" - even if they don't explicitly say "process mapper".
npx skillsauth add qa-aman/claude-skills process-mapperInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
references/bpmn-notation.md - BPMN 2.0 symbol reference table with events, activities, gateways, flows, and swimlanes. Read this in Step 3 when mapping processes using BPMN notation.Based on Business Process Change by Paul Harmon - the BPTrends 3-level process architecture (Enterprise, Business Process, Implementation) that prevents the most common process mapping mistake: starting at the wrong level of detail. Also draws on Business Analysis Techniques by James Cadle for BPMN notation and swimlane techniques, and Rummler-Brache's 3-level analysis (Organization, Process, Performer). The key insight from Harmon: before you draw a single box or arrow, locate the process within the enterprise value chain. A process mapped at the wrong level is either too abstract to act on or too detailed to see the real problems.
Determine which level you are mapping:
Most BA process mapping operates at Level 2. Start at Level 1 to establish context, then zoom into Level 2.
PROCESS NAME: [name]
TRIGGER: [what starts this process - event, request, schedule]
END EVENT: [what marks completion - output delivered, decision made, state changed]
IN SCOPE: [subprocesses included]
OUT OF SCOPE: [adjacent processes excluded]
OWNER: [who is accountable for this process]
Using BPMN notation (see references/bpmn-notation.md):
Apply metrics at each of Rummler-Brache's 3 levels:
Annotate the AS-IS map with actual metrics. Highlight pain points: bottlenecks, rework loops, unnecessary approvals, manual steps that could be automated.
Apply Harmon's redesign principles:
| Change | AS-IS | TO-BE | Impact | Owner |
|--------|-------|-------|--------|-------|
| [description] | [current state] | [future state] | [who/what is affected] | [responsible] |
Deliver: process diagrams (AS-IS and TO-BE), metrics comparison, change register, and recommended implementation sequence.
1. Mapping at the wrong level of detail Bad: Starting with Level 3 task-level detail before understanding where the process sits in the value chain. Good: Start at Level 1 (context), zoom to Level 2 (process), drill into Level 3 only where pain points exist.
2. Missing swimlane handoffs Bad: Process flow with all steps in a single lane - hides the cross-functional complexity. Good: Every role or system gets its own lane; every arrow crossing a lane boundary is a handoff worth examining.
3. AS-IS without metrics Bad: Drawing the current process without measuring it. ("We think it takes about a week.") Good: Annotate with actual cycle time, error rates, and throughput. If data doesn't exist, that's a finding.
4. TO-BE that's just "automate everything" Bad: Future state where every manual step is replaced by a system. Good: Apply Harmon's sequence: eliminate first, then simplify, then integrate, then automate. Many problems are solved by removing steps, not by building software.
5. No trigger or end event Bad: Process map that starts with "Step 1" and ends with "Done." Good: BPMN start event (what triggers this?) and end event (what state marks completion?).
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.