sd-write-journey

Writes schema-valid service-design journey documents with evidence-traced emotional curves.

3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/runlegion/legion --skill sd-write-journey-runlegion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sd-write-journey
Source: https://github.com/runlegion/legion/tree/main/plugin/skills/sd-write-journey
Command: npx skills add https://github.com/runlegion/legion --skill sd-write-journey-runlegion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Service-design journeys often contain invented feelings and unsupported pain points. This Skill produces journey documents where every emotional dip traces to a Discovery insight and every high point traces to a grounded value exchange, so the artifact survives critical review. ## Core Features & Use Cases - Schema-valid journey authoring: Drafts against the live journey schema resolved from legion document list, then validates and creates the document via legion document validate and legion document create. - Evidence-traced emotional curves: Each phase carries valence numbers (-3 to 3) and plain emotion words drawn only from evidence; dips must name a Discovery insight in the phase's frictions row, and contradicted or blocked insights cannot anchor a dip. - Prediction instrumentation: Emits one confidence-scored prediction per journey via legion uncertainty emit, witnessed later by the crit step that moves the document past draft. - Use Case: After a persona document exists, invoke this Skill to walk that persona through a real scenario the ecosystem's channels can carry, producing a validated journey document with a staked confidence score. ## Quick Start Ask the agent to write a journey for an existing persona document through a scenario supported by the current ecosystem, then report the created document id and prediction id.

Frequently Asked Questions about sd-write-journey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a customer journey map with evidence-based emotions?

Read the persona, Discovery, Ecosystem, and intent documents, then draft each phase with actions and touchpoints from the ecosystem's channels. Place emotional_start and emotional_end valence numbers from -3 to 3 based on evidence direction and strength, and use plain emotion words the evidence shows.

How do I validate a journey document against a schema?

Resolve the live schema by its x-doc-type journey value from legion document list --doc-type schema --json, then run legion document validate --schema <schema-id> --file journey.json before creating the document with legion document create.

Can a journey include pain points not backed by research insights?

No. Every low point in the emotional curve must trace to a Discovery insight named in the phase's frictions row. Contradicted claims, blocked insights, and saturated-unevidenced insights cannot anchor a dip.

What happens when the service being journeyed is not built yet?

For a greenfield intent, mark each phase touching the unbuilt service by appending (planned future) to the phase title and noting it in meta.scenario. High points must otherwise trace to value exchanges the ecosystem grounds today.

Why does the journey writer emit a prediction after creating the document?

The prediction stakes a claimed confidence that the crit will accept the journey without striking affect as invented or dips as untraced. The crit later witnesses it by rebuilding the fingerprint from the persona id and journey id.