service-blueprint · podo — Claude Code skill: what it does, how to install
Draws a service blueprint with five swim lanes and the lines of interaction, visibility and internal interaction, then renders it to HTML or Mermaid.
MIT 203 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill service-blueprint -a claude-codeWhat service-blueprint does
The skill lays out a service blueprint: five swim lanes for what the user does, the frontstage, the backstage and the support processes, cut by the lines of interaction, visibility and internal interaction. The method follows Nielsen Norman Group, the UK Government Digital Service and Practical Service Design.
Three documents carry the work: METHODOLOGY.md for the method itself, SCHEMA.md for a JSON schema of a blueprint, RENDERING.md for the HTML and Mermaid output. Example blueprints and a stylesheet come with them, along with facilitation timing and moments-of-truth analysis.
One catch on naming: designer-skills also ships a skill called service-blueprint. With both installed, the later one overwrites the earlier.
What it helps with
- map a service end to end across frontstage and backstage lanes
- mark which steps the customer sees and which sit behind the visibility line
- keep the blueprint as JSON and render it to HTML or Mermaid
- run a timed facilitation session and flag the moments of truth
- check the diagram against NN/g and GDS practice
Example prompts for the agent
- Blueprint our clinic booking service with five lanes and the visibility line.
- Render the finished
blueprint.jsonas HTML and Mermaid. - Run the facilitation from
METHODOLOGY.mdand mark the moments of truth.
How to install service-blueprint
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill service-blueprint -a claude-code2Manually: put the files in place
~/.claude/skills/service-blueprint/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/service-blueprint/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill service-blueprint -a codex2Manually: put the files in place
.agents/skills/service-blueprint/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill service-blueprint -a cursor2Manually: put the files in place
.cursor/skills/service-blueprint/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/service-blueprint2Manually: put the files in place
.github/skills/service-blueprint/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill service-blueprint -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/service-blueprintManually: put the files in place
.devin/skills/service-blueprint/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill service-blueprint -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 service-blueprint
How do I install service-blueprint in Claude Code?
Run npx skills add podo/design-agent-skills --skill service-blueprint -a claude-code. The skill ends up at ~/.claude/skills/service-blueprint/SKILL.md.
What does service-blueprint do?
It builds a service blueprint using the NN/g, GDS and Practical Service Design method, arranging the work in five swim lanes across three lines, and outputs HTML or Mermaid.
What if a skill named service-blueprint is already installed?
designer-skills has one under the same name. Installing this version overwrites it, so pick which method you want first.
Source text
SKILL.md · MIT
---
name: service-blueprint
description: |
Generate professional service blueprints (NN/g, GDS, Practical Service Design): the five
swim lanes, lines of interaction/visibility/internal-interaction, plus a JSON schema and render pipeline.
triggers:
- "service blueprint"
- "service design blueprint"
- "frontstage backstage"
- "service delivery map"
das:
type: package
category: design-review
upstream: "https://github.com/j-clegg/service-blueprint-skill"
version: latest
---
# service-blueprint
> Catalogue stub — full package: [j-clegg/service-blueprint-skill](https://github.com/j-clegg/service-blueprint-skill)
<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree
1. **Is the full skill already installed?**
- `f=~/.agents/service-blueprint-skill/SKILL.md; [ -e "$f" ] && ! grep -qs "^das:" "$f" && echo "installed" || echo "pointer"`
- `installed` → invoke it and proceed
- `pointer` → go to step 2
2. **Install** (the skills CLI cannot install this one):
The upstream SKILL.md has no YAML frontmatter (name, description), so the skills CLI skips it and installs nothing ("No valid skills found"). Clone the repo to a fixed folder and have your agent read its SKILL.md directly; this pointer stays installed as the entry point.
```bash
git clone --depth=1 https://github.com/j-clegg/service-blueprint-skill.git ~/.agents/service-blueprint-skill
```
**Heads-up**
- **License:** MIT
- **Name collision:** `service-blueprint` is also written by `designer-skills` (its install or its catalogue pointer); installing both overwrites the earlier one.
<!-- das:install:end -->
## Invoke after install
- Read `~/.agents/service-blueprint-skill/SKILL.md` and follow it; it points to `METHODOLOGY.md`, `SCHEMA.md` and `RENDERING.md` in the same folder
- Trigger phrases: "service blueprint", "service design blueprint", "frontstage backstage", "service delivery map"
## What it does
A service-blueprint package: sourced methodology (`METHODOLOGY.md`), a machine-readable blueprint schema (`SCHEMA.md`), and an HTML/Mermaid output pipeline (`RENDERING.md`) with example blueprints and a stylesheet. Maps user actions, frontstage, backstage, and support processes across the lines of interaction, visibility and internal interaction, with timed facilitation and moments-of-truth analysis. Follows methodology from Nielsen Norman Group, the UK Government Digital Service and Practical Service Design.
## When NOT to use
- Single-user emotional journey only → use a journey-map skill
- High-level UX strategy → use `design-consultation`
- You want a skill the skills CLI can install and register by name → use `designer-skills`, whose `service-blueprint` skill is a lighter take on the same method
© podo · MIT · podo/design-agent-skills
Similar skills
All skills for Design →service-blueprint by other authors comes first.