yao-tutorial-skill

Name: yao-tutorial-skill
Author: yaojingang

github.com/yaojingangDocuments1.3k92 installsUpdated 2w ago

About yao-tutorial-skill

Yao Tutorial Skill is a production workflow for formal tutorials, suited to work that requires research, instructional design, and delivery in multiple formats. It combines source review, chapter writing, visuals, export, and quality checks.

Key features

01Normalize topics, audiences, and deliverables
02Register sources and map supporting evidence
03Write a standalone tutorial and outline
04Plan and build chapter visuals
05Export and validate delivery files

Use cases

01Develop a tutorial from user-provided material
02Add research sources and evidence to a tutorial
03Create teaching materials with chapter visuals
04Check HTML, DOCX, or PDF delivery packages

Install

Copy the command and run it in a terminal.

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

After installing, type/yao-tutorial-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/

interface.yaml

evals/

semantic_config.json

trigger_cases.json

examples/english-freedom-route/

brief.json

outline.md

tutorial.md

examples/english-freedom-route/exports/

tutorial-reference.docx

examples/english-freedom-route/research/

chapter-quality-review.md

evidence-map.md

source-register.md

user-materials-register.md

examples/english-freedom-route/visuals/

chapter-01.svg

chapter-02.svg

chapter-03.svg

chapter-04.svg

chapter-05.svg

chapter-06.svg

chapter-07.svg

index.html

visual-spec.json

examples/meta-skill-giants-shoulders/

brief.json

outline.md

tutorial.md

examples/meta-skill-giants-shoulders/exports/

tutorial-reference.docx

examples/meta-skill-giants-shoulders/research/

chapter-quality-review.md

evidence-map.md

source-register.md

examples/meta-skill-giants-shoulders/visuals/

chapter-01.svg

chapter-02.svg

chapter-03.svg

Details

From the project README

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

Comments

Markdown supported

Details

Author: yaojingang
Repository: yaojingang/yao-open-skills
Category: Documents
Installs: 92
GitHub stars: 1,325

Report

More skills

All skills

handoff

github.com/mattpocock

1.1M

Compact the current conversation into a handoff document for another agent to pick up

lark-doc

open.feishu.cn

823.9k

Operate on Feishu cloud documents (Docx / Wiki): read, create, and edit documents; insert or download image attachments; and work with mind notes. Use when the user provides a document URL/token (including /docx/ or /wiki/ on doubao.com); route by URL path/token rather than domain. `/page/<token>` is a Miaoda app, not a Feishu cloud document. Route embedded document resources according to the unified rules in the reading reference. Use lark-drive for standalone comment operations; use docs +fetch to read comments alongside the main text. Operations on spreadsheet or Base internal data are outside this skill.

lark-drive

open.feishu.cn

823.2k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.