sd-intent-review

Derives a testable research agenda of services and claims from a repository intent document.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting service design directly from a raw intent document risks jumping straight to designed services without validating whether the intent's claims hold up. This Skill reads a repo's intent document and produces a research agenda -- candidate services to test and claims to test -- where every item traces back to a specific intent field, so downstream discovery work validates hypotheses against real discourse instead of rubber-stamping assumptions. ## Core Features & Use Cases - Distill gate: Cold-reads the intent against distill checks and halts with specific gaps if the intent cannot be acted on from its own text, before any agenda is derived. - Agenda derivation: Produces services_to_test entries ({name, actor, goal, test}) and claims_to_test entries ({claim, who, evidence_target, right_if}), each traced to an intent field such as what_it_is, cut_or_broken, open_questions, or evidence. - Prediction instrumentation: Emits one staked prediction per claim via legion uncertainty emit, with confidence anchored to the intent's own evidence fields, so sd-discover can later witness each claim as supported, bounded, or contradicted. - Use Case: At the start of a repo's service design, invoke this Skill on the intent document to get a structured agenda of hypotheses with prediction ids, then hand that agenda to sd-discover for evidence-based validation. ## Quick Start Review the intent document for this repo and produce a research agenda of services and claims to test before any service design begins.

Frequently Asked Questions about sd-intent-review

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

FAQPage Schema
How do I start service design from an intent document?

Invoke the intent review step first: it reads the intent with legion document view, gates it against distill checks, and outputs a research agenda of services_to_test and claims_to_test. No services are designed at this stage; that happens only after claims are tested.

What does the intent review agenda contain?

The agenda contains services_to_test entries ({name, actor, goal, test}) and claims_to_test entries ({claim, who, evidence_target, right_if}). Every item traces to a specific intent field and carries a key plus a prediction id for downstream witnessing.

When does intent review refuse to proceed?

It halts when the intent fails the distill gate: a claim lacking its own substance, a bare pointer to another document, or contradictory blocks. It emits the specific gaps and derives no agenda, sending the intent back to its writer.

How are prediction confidence scores assigned to claims?

Confidence anchors come from the intent's evidence fields: about 0.7 for claims with an existing lens and query, 0.5 for cut_or_broken implications with a lens, and 0.3 for crawl-only lenses or doubted needs. Firsthand audit or reflection sources move the number up; admitted known gaps move it down.

Who witnesses the predictions emitted during intent review?

sd-discover witnesses them at its authoritative scoring pass, reading each prediction id from the agenda. Supported verdicts score as shipped at 1.0, bounded as scoped-down at 1.0, contradicted as abandoned at 0.0; blocked or saturated-unevidenced claims stay unwitnessed.