Skip to content
cccskills
FreePublished on GitHub

source-tutorial-spec

Use when a `source-tutorial` workspace has ingested sources and needs a grounded tutorial contract before structure planning.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md1.6 KB
  • scripts/run.py1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Source Tutorial Spec

Triggers & routing

  • Trigger: source tutorial spec, tutorial from sources, learner profile, 教程规格, 从资料生成教程.
  • Use when: source-tutorial 的 C2,需要根据 sources/index.jsonl / sources/provenance.jsonl 锁定 audience、prerequisites、learning objectives、source scope 和 running example policy。

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Internal template for creating or refactoring a skill into the repository's reference-first shape. **Trigger**: reference-first template, blueprint skill, create a reusable skill, refactor a script-heavy skill. **Use when**: you need a lean `SKILL.md`, explicit `references/`, machine-readable `assets/`, and a minimal deterministic `run.py`.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

Download a small corpus of open-access arXiv survey/review PDFs about agentic systems and extract text for style learning.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

Extract per-subsection “anchor facts” (NO PROSE) from evidence packs so the writer is forced to include concrete numbers/benchmarks/limitations instead of generic summaries.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

Curate reader-facing survey tables for the Appendix (clean layout + high information density), using only in-scope evidence and existing citation keys.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

Build a final, machine-readable argument snapshot from current H3 sections and refresh section fingerprints before merge.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

Audit one research Workspace for declared Unit outputs and Pipeline target Artifacts, writing `output/CONTRACT_REPORT.md`; use for mid-Run coverage snapshots or final delivery completeness, not deep provenance integrity.

The English summary is being prepared. Showing the original description.

WILLOSCAR/research-units-pipeline-skills513Updated Oct 5, 2026

See all skills by WILLOSCAR

Report a problem with this skill