sd-write-persona

Writes one schema-valid service-design persona traced to Discovery insights and intent fields.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Service-design personas often become invented character sketches with demographics and interiority that no evidence supports. This Skill produces a persona where every statement traces back to a Discovery insight or an intent field, so design decisions rest on evidence rather than imagination. ## Core Features & Use Cases - Evidence-traced persona generation: Builds identity, goals, behaviors, frustrations, and would_leave_if entries strictly from the intent, Discovery, and ecosystem documents, with frustrations linked to insight ids. - Schema-validated output: Resolves the live persona schema via legion document list, drafts against its required fields, validates with legion document validate, and creates the document with legion document create. - Agent-as-customer support: Handles ecosystems where the primary actor is an agent, writing the agent persona and the unaware human beneficiary separately. - Uncertainty instrumentation: Emits one staked prediction per persona via legion uncertainty emit, with confidence anchors based on trace quality, witnessed later by the crit step. - Use Case: After landing a Discovery and ecosystem for a CLI product, invoke this Skill to produce a draft persona document whose frustrations each cite a supported insight id, ready for crit review. ## Quick Start Ask the agent to write a persona for the primary actor in the landed ecosystem, tracing every statement to the Discovery insights and intent.

Frequently Asked Questions about sd-write-persona

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

FAQPage Schema
How do I write an evidence-based service design persona?

Read the intent, Discovery, and ecosystem documents by id, draft the persona against the live schema, and fill each field only with content traced to insights or intent stakes. Validate with legion document validate, then create it with legion document create.

How do I write a persona when the customer is an AI agent?

Write the agent persona around how it chooses tools, reads output, and recovers from errors, and write the human persona separately as an unaware beneficiary who sees only outcomes. Never invent a direct touchpoint between the human and the product.

Can a persona include frustrations without a Discovery insight?

No. Every frustration must trace to a Discovery insight id, and contradicted, blocked, or saturated-unevidenced insights are excluded. The skill refuses frustrations built on unsupported claims.

Does this skill allow demographics or invented quotes in personas?

No. Demographics, flavor names, and unsupported interiority are refused. Quotes must be verbatim from evidence or composed strictly from traced clauses and marked with (composed).

When should I invoke the persona writer in the design workflow?

Invoke it only after the Discovery and ecosystem documents are landed, since the persona's actor must already exist in the ecosystem's actors. One persona is written per invocation; run it again for each additional actor.