Skip to content
Skills Library
Education · Writing

yao-tutorial-skill

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

Licence
MIT
Last repository change
14.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
71
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • Paczka skrócona: część plików jest zbyt duża or wykonywalna. Pełny folder jest w repozytorium.

What it does and when to use it

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.

Original author 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.

How it works

  1. Workflow
  2. Quality Gates
  3. References
Original SKILL.md headings · 37 lines, 245 words
SKILL.md preview
---
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.
---

# 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`
Files in this package (71)
  • README.md 4 KB
  • SKILL.md 3 KB
  • manifest.json 1 KB
  • agents/interface.yaml 1 KB
  • evals/semantic_config.json 5 KB
  • evals/trigger_cases.json 2 KB
  • examples/README.md 2 KB
  • examples/english-freedom-route/brief.json 1 KB
  • examples/english-freedom-route/outline.md 1 KB
  • examples/english-freedom-route/tutorial.md 19 KB
  • examples/english-freedom-route/assets/screenshots/chapter-01.png 130 KB
  • examples/english-freedom-route/assets/screenshots/chapter-02.png 121 KB
  • examples/english-freedom-route/assets/screenshots/chapter-03.png 159 KB
  • examples/english-freedom-route/assets/screenshots/chapter-04.png 120 KB
  • examples/english-freedom-route/assets/screenshots/chapter-05.png 117 KB
  • examples/english-freedom-route/assets/screenshots/chapter-06.png 104 KB
  • examples/english-freedom-route/assets/screenshots/chapter-07.png 131 KB
  • examples/english-freedom-route/exports/tutorial-preview.png 477 KB
  • examples/english-freedom-route/exports/tutorial-reference.docx 11 KB
  • examples/english-freedom-route/exports/tutorial.docx 807 KB
  • examples/english-freedom-route/research/chapter-quality-review.md 2 KB
  • examples/english-freedom-route/research/evidence-map.md 1 KB
  • examples/english-freedom-route/research/source-register.md 1 KB
  • examples/english-freedom-route/research/user-materials-register.md 1 KB
  • examples/english-freedom-route/visuals/chapter-01.svg 5 KB
  • examples/english-freedom-route/visuals/chapter-02.svg 6 KB
  • examples/english-freedom-route/visuals/chapter-03.svg 6 KB
  • examples/english-freedom-route/visuals/chapter-04.svg 6 KB
  • examples/english-freedom-route/visuals/chapter-05.svg 6 KB
  • examples/english-freedom-route/visuals/chapter-06.svg 5 KB
  • examples/english-freedom-route/visuals/chapter-07.svg 6 KB
  • examples/english-freedom-route/visuals/index.html 6 KB
  • examples/english-freedom-route/visuals/visual-spec.json 5 KB
  • examples/meta-skill-giants-shoulders/brief.json 1 KB
  • examples/meta-skill-giants-shoulders/outline.md 2 KB
  • examples/meta-skill-giants-shoulders/tutorial.md 22 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-01.png 138 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-02.png 113 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-03.png 128 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-04.png 151 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-05.png 130 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-06.png 170 KB
  • examples/meta-skill-giants-shoulders/assets/screenshots/chapter-07.png 149 KB
  • examples/meta-skill-giants-shoulders/exports/tutorial-preview.png 366 KB
  • examples/meta-skill-giants-shoulders/exports/tutorial-reference.docx 11 KB
  • examples/meta-skill-giants-shoulders/exports/tutorial.docx 907 KB
  • examples/meta-skill-giants-shoulders/research/chapter-quality-review.md 2 KB
  • examples/meta-skill-giants-shoulders/research/evidence-map.md 1 KB
  • examples/meta-skill-giants-shoulders/research/source-register.md 1 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-01.svg 6 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-02.svg 5 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-03.svg 5 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-04.svg 5 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-05.svg 6 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-06.svg 6 KB
  • examples/meta-skill-giants-shoulders/visuals/chapter-07.svg 7 KB
  • examples/meta-skill-giants-shoulders/visuals/index.html 6 KB
  • examples/meta-skill-giants-shoulders/visuals/visual-spec.json 6 KB
  • examples/python-beginner-to-mastery/brief.json 1 KB
  • examples/python-beginner-to-mastery/outline.md 1 KB
  • examples/python-beginner-to-mastery/tutorial.md 14 KB
  • examples/python-beginner-to-mastery/assets/screenshots/chapter-01.png 117 KB
  • examples/python-beginner-to-mastery/assets/screenshots/chapter-02.png 126 KB
  • examples/python-beginner-to-mastery/assets/screenshots/chapter-03.png 104 KB
  • examples/python-beginner-to-mastery/assets/screenshots/chapter-04.png 118 KB
  • examples/python-beginner-to-mastery/exports/tutorial-reference.docx 11 KB
  • examples/python-beginner-to-mastery/research/chapter-quality-review.md 2 KB
  • examples/python-beginner-to-mastery/research/evidence-map.md 1 KB
  • examples/python-beginner-to-mastery/research/source-register.md 3 KB
  • examples/python-beginner-to-mastery/visuals/chapter-01.svg 5 KB
  • examples/python-beginner-to-mastery/visuals/visual-spec.json 4 KB

Omitted from the package: 34 (too large or executable); available in the repository.

Versions

The database has no other skills named yao-tutorial-skill.

Database snapshot: 13.11.2026 · package version 83484a8036f5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100yao-expert-skill
    Create expert-level learning reports and tutorials from any domain, industry, technology, role, market, product idea, or vague field question. Use when the user wants to quickly build domain expertise, understand an industry, generate a structured expert study report, build a…
  • 100book-to-course
    Turn a book or document (EPUB, PDF, HTML, DOCX, Markdown, TXT — e.g. a programming course book) into a complete interactive beginner-friendly course delivered as a local web page, with step-by-step explanations, animations, quizzes, chapter tests, flashcards, hints, programming…
  • 100course-builder
    Design course architecture and write module content. Use when user says "build a course", "create a course on", "design a learning path", "course outline", "write a module", or "curriculum design".
  • 100claude-docs-course
    Generate an interactive, self-contained HTML course on any Claude documentation topic. Use this skill when the user wants to create an interactive course, tutorial, or deep-dive walkthrough about a Claude feature, API concept, SDK pattern, or prompt engineering technique.…
  • 100course
    Build a research-driven, principles-first course on any topic (problems first, then principles with pseudocode and mental models, tools and languages only in the final phase), or add a chapter to an existing course. Use when the user says "/course <topic>", "build me a course on…
  • 90course-planner
    Plan a course structure, learning goals, modules, and outline from a user request. Use when a user wants to design a course before scheduling it.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.