Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill service-blueprint -a claude-code
Open on GitHub

What 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.json as HTML and Mermaid.
  • Run the facilitation from METHODOLOGY.md and 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-code

2Manually: put the files in place

~/.claude/skills/service-blueprint/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/service-blueprint/

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.

service-blueprint Owl-Listener service-blueprint is a Claude Code skill that maps how a service gets delivered across customer-facing work and internal operations. It activates for service design or diagnosis when staff and processes shape the experience. CX Codex +1 2,200installs service-check haabe service-check scores a service or feature against Lou Downe's 15 principles of good services and returns a Pass / Partial / Fail table with the fixes that matter most. CX Codex +1 ★ 54repo stars journey-mapping rampstackco The journey-mapping skill creates customer journey maps and service blueprints that visualize the full user experience: touchpoints, emotions, friction, and underlying systems. CX Codex +1 300installs blueprint WordPress A skill for working with WordPress Playground Blueprint — JSON files that set up a Playground instance: install plugins and themes, configure options, run PHP and SQL. CX Codex +1 4,300installs ue-blueprint-cpp-interop quodsoler The ue-blueprint-cpp-interop skill covers C++ and Blueprint interop in Unreal Engine, from exposed functions and events to async nodes and native calls into Blueprint. CX Codex +1 512installs vtex-io-service-configuration-apps vtex vtex-io-service-configuration-apps guides the agent through building VTEX IO configuration apps using the configuration builder. Helps inject decoupled workspace settings into service runtimes. CX Codex +1 1,200installs data-model-designer datadrivenconstruction data-model-designer — a skill for Claude Code, Codex, Cursor and other agents that designs data models for construction projects: entities, relationships, schemas. Outputs SQL DDL, JSON Schema, and Mermaid ER diagrams. CX Codex +1 116installs

From the same set108

The whole set →
claude-wireframe-skill Generates 5 UX design approaches as interactive prototypes. Starts with black-and-white wireframes, then builds color versions using parallel agents. CX Codex +1 203installs pm-skills pm-skills — a set of product-management skills maps work to the Triple Diamond method, from problem framing through experiments and iteration. CX Codex +1 203installs figma-variables-tokens-generator figma-variables-tokens-generator interviews you about design system properties and produces a W3C DTCG token ZIP archive. Useful for structuring tokens ready for import into Figma Variables. CX Codex +1 203installs microsoft-skills Two Microsoft skills for interface review and dark React UI. Use them for design-system checks or dashboards built with Tailwind and Framer Motion. CX Codex +1 203installs nimbalyst-skills Three visual slash commands from Nimbalyst: Excalidraw diagrams, UI wireframes and database ERDs. They run inside the desktop app, not on their own. CX Codex +1 203installs figma-catalogue The figma-catalogue Claude Code skill points to tools for Figma, design systems, and design-to-code work. It activates on requests about token management, Figma workflows, or official platform skill collections. CX Codex +1 202installs cc-slidev cc-slidev — a skill for conference and developer talks built on Slidev: hard limits on slide layout, and a path from outline to export. CX Codex +1 202installs lenny-skills Product management frameworks and checklists from Lenny Rachitsky's podcast archive. Helps teams draft PRDs, refine onboarding, and design AI-native UX. CX Codex +1 202installs

Project sponsors

Companies that keep this analytics open