yao-tutorial-skill

Create standalone beginner tutorial packages from a topic or supplied references, with adaptive research, course-style outline design, chapter visuals, and…

Skill by yaojingang

IndexedMIT★ 1,324

Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/yaojingang-yao-tutorial-skill

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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.

Use cases: documents, design, frontend, research

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/yao-tutorial-skill

What's inside

Skill name: yao-tutorial-skill
Description: 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.
License: MIT
Instructions: 37 lines in SKILL.md · view on GitHub

Before installing

Ships executable scripts

Files (105)

README.md
SKILL.md
interface.yaml · agents/
semantic_config.json · evals/
trigger_cases.json · evals/
README.md · examples/
chapter-01.png · examples/english-freedom-route/assets/screenshots/
chapter-02.png · examples/english-freedom-route/assets/screenshots/
chapter-03.png · examples/english-freedom-route/assets/screenshots/
chapter-04.png · examples/english-freedom-route/assets/screenshots/
chapter-05.png · examples/english-freedom-route/assets/screenshots/
chapter-06.png · examples/english-freedom-route/assets/screenshots/
chapter-07.png · examples/english-freedom-route/assets/screenshots/
brief.json · examples/english-freedom-route/
tutorial-preview.png · examples/english-freedom-route/exports/
tutorial-reference.docx · examples/english-freedom-route/exports/
tutorial.docx · examples/english-freedom-route/exports/
tutorial.html · examples/english-freedom-route/exports/
tutorial.pdf · examples/english-freedom-route/exports/
outline.md · examples/english-freedom-route/
chapter-quality-review.md · examples/english-freedom-route/research/
evidence-map.md · examples/english-freedom-route/research/
source-register.md · examples/english-freedom-route/research/
user-materials-register.md · examples/english-freedom-route/research/
tutorial.md · examples/english-freedom-route/
chapter-01.svg · examples/english-freedom-route/visuals/
chapter-02.svg · examples/english-freedom-route/visuals/
chapter-03.svg · examples/english-freedom-route/visuals/
chapter-04.svg · examples/english-freedom-route/visuals/
chapter-05.svg · examples/english-freedom-route/visuals/
chapter-06.svg · examples/english-freedom-route/visuals/
chapter-07.svg · examples/english-freedom-route/visuals/
index.html · examples/english-freedom-route/visuals/
visual-spec.json · examples/english-freedom-route/visuals/
chapter-01.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-02.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-03.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-04.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-05.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-06.png · examples/meta-skill-giants-shoulders/assets/screenshots/
chapter-07.png · examples/meta-skill-giants-shoulders/assets/screenshots/
brief.json · examples/meta-skill-giants-shoulders/
tutorial-preview.png · examples/meta-skill-giants-shoulders/exports/
tutorial-reference.docx · examples/meta-skill-giants-shoulders/exports/
tutorial.docx · examples/meta-skill-giants-shoulders/exports/
tutorial.html · examples/meta-skill-giants-shoulders/exports/
tutorial.pdf · examples/meta-skill-giants-shoulders/exports/
outline.md · examples/meta-skill-giants-shoulders/
chapter-quality-review.md · examples/meta-skill-giants-shoulders/research/
evidence-map.md · examples/meta-skill-giants-shoulders/research/
source-register.md · examples/meta-skill-giants-shoulders/research/
tutorial.md · examples/meta-skill-giants-shoulders/
chapter-01.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-02.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-03.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-04.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-05.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-06.svg · examples/meta-skill-giants-shoulders/visuals/
chapter-07.svg · examples/meta-skill-giants-shoulders/visuals/
index.html · examples/meta-skill-giants-shoulders/visuals/
…and 45 more

SKILL.md (first lines)

# 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 `build_visual_pack.py` and `capture_visuals.py`.
6. Read `references/export-workflow.md`; run `export_tutorial.py` and then `validate_package.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/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`

From yaojingang/yao-open-skills, MIT.

Signals

Stars: 1,324
Forks: 144
Open issues: 0
Last commit (this folder): Jun 19, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License: MIT
Repository: github.com/yaojingang/yao-open-skills
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from yaojingang

Cite this page

yao-tutorial-skill. Agent Mart. https://agentmart.dev/skills/yaojingang-yao-tutorial-skill (last updated 2026-10-24)