yao-tutorial-skill

Create standalone beginner tutorial packages from a topic or supplied references, with adaptive research, course-style outline design, chapter visuals, and Markdown/DOCX/PDF/HTML exports. Use for textbook-like tutorials, course guides, teaching documents, or long beginner guides; not for quick answers, link summaries, pure diagrams, or file conversion.

Jump to install

Repository: yaojingang/yao-open-skills
Last source activity: June 19, 2026 at 02:19
Detected SKILL.md language: English
Stars: 1,310
Forks: 147

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/yaojingang/yao-open-skills --skill yao-tutorial-skill

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

100 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Yao Tutorial Skill

Workflow

Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into brief.json.

Read references/input-adaptation.md; use user material as the spine when sufficient, then add only needed external research.

Read references/research-sourcing.md; create research/user-materials-register.md when needed, research/source-register.md, and research/evidence-map.md.

Read references/tutorial-outline-and-writing.md plus references/course-design-principles.md; write outline.md, standalone public tutorial.md using 第1章 and 1.1, and research/chapter-quality-review.md.

Read the editorial and visual references; create visuals/visual-spec.json, then run build_visual_pack.py and capture_visuals.py.

Read references/export-workflow.md; run export_tutorial.py and then validate_package.py.

Report exact failures and fallbacks. Never fabricate X posts, papers, repo details, dates, or citations.

Quality Gates

User material controls intent when strong enough; external evidence fills verification and gaps.

Public exports never show internal source IDs or reference-packet provenance.

Copy reads as a standalone formal teaching product.

Every numbered chapter has a matching visual spec and embedded visual.

Depth is governed by learning sufficiency, not a fixed word limit; continue until the learner can understand, apply, and self-check the topic.

Every numbered chapter has an independent quality review for depth, examples, practice, evidence, visual fit, and back-half consistency.

HTML uses centered report-shell; DOCX/PDF have no visible headers, footers, local paths, or print chrome.

Delivery passes scripts/validate_package.py or names the remaining warnings/failures.

References

references/input-adaptation.md

references/research-sourcing.md

references/tutorial-outline-and-writing.md

references/course-design-principles.md

references/editorial-production.md

references/visual-html-workflow.md

references/visual-board-benchmarks.md

references/export-workflow.md

scripts/build_visual_pack.py, scripts/capture_visuals.py, scripts/export_tutorial.py, scripts/validate_package.py

templates/topic-brief-template.json, templates/visual-spec-template.json, templates/tutorial-style.css