---
name: willoscar/source-tutorial-spec
source: https://app.decimal.ai/s/willoscar-source-tutorial-spec@1/SKILL.md
source_sha256: f6194ec147b6
---

# Source Tutorial Spec

Builds the C2 tutorial contract from the ingested source corpus, not from a bare topic prompt.

## Inputs

- `sources/index.jsonl`
- `sources/provenance.jsonl`
- `GOAL.md`
- `DECISIONS.md`

## Output

- `output/TUTORIAL_SPEC.md`

## Contract

The spec must include:
- `## Audience`
- `## Prerequisites`
- `## Learning objectives`
- `## Non-goals`
- `## Source scope`
- `## Running example policy`
- `## Delivery shape`

It should also embed machine-readable structured data for downstream deterministic planning.

## Script boundary

`scripts/run.py` should:
- read the ingested source bundle
- derive a grounded tutorial scope
- write the markdown spec and structured seed block

Keep phrase extraction, concept selection, and source matching in shared tutorial tooling, not in the thin skill wrapper.

## Acceptance

- `output/TUTORIAL_SPEC.md` exists
- the required sections are present
- source families are named explicitly
- running example policy is concrete or explicitly omitted

## Non-goals

- concept DAG construction
- module sequencing
- tutorial prose writing