Skip to content
cccskills
FreePublished on GitHub

source-tutorial-writer

Use when approved tutorial context packs exist and the run needs the final article-first tutorial deliverable.

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

See how to install

Files included (2)

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

SKILL.md (original)

Review the instructions the agent will receive before you install.

Source Tutorial Writer

Triggers & routing

  • Trigger: source tutorial writer, tutorial drafting, 教程正文, 从资料写教程.
  • Use when: source-tutorial 的 C3,outline/tutorial_context_packs.jsonl 已就绪,且 DECISIONS.md 已勾选 Approve C2。
  • Skip if: C2 未批准,或 context packs 还没准备好。
  • Network: none.
  • Guardrail: 正文必须 reader-first,但不能写出 sources 没支持的内容。

Writes the final tutorial markdown from approved module packs and the locked C2 structure.

Inputs

  • outline/tutorial_context_packs.jsonl
  • outline/module_plan.yml
  • DECISIONS.md

Output

  • output/TUTORIAL.md

Contract

The tutorial must:

  • start with reader orientation
  • follow the approved module order
  • keep per-module teaching sections explicit
  • keep source notes visible but lightweight

Per module, the writer should emit:

  • ### Why it matters
  • ### Key idea
  • ### Worked example
  • ### Check yourself
  • ### Source notes

Script boundary

scripts/run.py should:

  • block on missing Approve C2
  • load module packs in approved order
  • render the deterministic tutorial scaffold/content into output/TUTORIAL.md

Keep rendering and pack interpretation in shared tutorial tooling, not in the wrapper.

Acceptance

  • output/TUTORIAL.md exists
  • the required reader-orientation sections exist
  • every module includes the required teaching subsections

Non-goals

  • self-loop QA reporting
  • article/slides compilation

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