yaojingang/yao-open-skills

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.

First seen Apr 30, 2026

Installation

$ npx skills add yaojingang/yao-open-skills --skill yao-tutorial-skill

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from yaojingang/yao-open-skills · top by installs.

npx skills add yaojingang/yao-open-skills

Browse all from yaojingang/yao-open-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.3K
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,796 B
  • docs SUMMARY.md 380 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 82 installs

SKILL.md

Yao Tutorial Skill

Workflow

  1. Normalize topic, audience, outcome, language, formats, user material, style references, and exclusions into brief.json.
  2. Read references/input-adaptation.md; use user material as the spine when sufficient, then add only needed external research.
  3. Read references/research-sourcing.md; create research/user-materials-register.md when needed, research/source-register.md, and research/evidence-map.md.
  4. 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.
  5. Read the editorial and visual references; create visuals/visual-spec.json, then run buildvisualpack.py and capture_visuals.py.
  6. Read references/export-workflow.md; run exporttutorial.py and then validatepackage.py.
  7. 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/buildvisualpack.py, scripts/capturevisuals.py, scripts/exporttutorial.py, scripts/validate_package.py
  • templates/topic-brief-template.json, templates/visual-spec-template.json, templates/tutorial-style.css