Agent-Skills.md

Agent Skills: Tutorial Self-Loop

Run a tutorial-specific quality gate and write a PASS/FAIL report for the final tutorial deliverable.

UncategorizedID: willoscar/research-units-pipeline-skills/tutorial-selfloop
51039

Install this agent skill to your local

pnpm dlx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/HEAD/.codex/skills/tutorial-selfloop

Skill Files

Browse the full folder contents for tutorial-selfloop.

Download Skill

Loading file tree…

.codex/skills/tutorial-selfloop/SKILL.md

Skill Metadata

Name
tutorial-selfloop
Description
"Run a tutorial-specific quality gate and write a PASS/FAIL report for the final tutorial deliverable."

Tutorial Self-Loop

Triggers & routing

  • Trigger: tutorial self-loop, tutorial quality gate, tutorial pass/fail, 教程自循环, 教程质量门.
  • Use when: source-tutorial 的 C3，已经有 output/TUTORIAL.md，想在交付前确认它满足教程合同而不是普通长文。
  • Skip if: 还没有 tutorial 正文。
  • Network: none.
  • Guardrail: 报告缺口时不要发明内容；把失败清楚地路由回 tutorial 写作阶段。

Goal: converge the tutorial deliverable to a stable teaching-quality bar.

The gate should compare output/TUTORIAL.md against the intended module shape from outline/module_plan.yml, rather than acting like a generic prose checker.

Inputs

  • output/TUTORIAL.md
  • outline/module_plan.yml

Outputs

  • output/TUTORIAL_SELFLOOP_TODO.md

Checks

  • reader orientation section exists
  • at least one real module exists
  • each module has teaching components, not just a block of prose
  • source notes are visible but lightweight

Script

Quick Start

  • uv run python .codex/skills/tutorial-selfloop/scripts/run.py --workspace <workspace>

All Options

  • --workspace <dir> (required)
  • --unit-id <U###>
  • --inputs <semicolon-separated>
  • --outputs <semicolon-separated>
  • --checkpoint <C#>

Examples

  • Run the tutorial gate:
    • uv run python .codex/skills/tutorial-selfloop/scripts/run.py --workspace <workspace>