Generate Explainer YAML
analyze a document, repository summary, pull request, README, design note, or specification and produce (or refine) the intermediate yaml files that drive the explainer pipeline — core.yaml (the semantic structure / meaning), view.yaml (the presentation strategy for a particular reader), and, by default, quiz.yaml (comprehension-check questions derived from core.yaml; skipped only when the user explicitly declines a quiz). use when the user wants to capture what a target means and how to show it before generating an html explainer, or wants to edit/reshape an existing core.yaml / view.yaml / q
Install
/plugin marketplace add hirokita117/yaml-to-html-skillThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add hirokita117/yaml-to-html-skill --skill generate-explainer-yamlgit clone --depth 1 https://github.com/hirokita117/yaml-to-html-skill.git /tmp/yaml-to-html-skill
mkdir -p ~/.claude/skills
cp -r /tmp/yaml-to-html-skill/skills/generate-explainer-yaml ~/.claude/skills/generate-explainer-yamlPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# generate-explainer-yaml Turn an understanding target — a pasted document, repository summary, PR/diff summary, README, design note, or spec — into the **intermediate YAML files** that the explainer pipeline runs on: 1. `core.yaml` — the **semantic structure** of the target (meaning, not UI): concepts, relations, importance, difficulty, confidence, questions, risks, source refs. 2. `view.yaml` — **how to present it to this particular reader**: audience, preferred and avoided forms, density, tone, emphasis, generation policy. 3. `quiz.yaml` — **comprehension-check questions** derived from `core.yaml` (choices, answers, explanations, difficulty). Produced **by default**; skip it only when the user explicitly declines a quiz. This skill is the **first half** of the pipeline. It does not produce HTML. Once the YAML files exist, the **`generate-explainer-html`** skill reads them (by absolute path) and builds a switchable, light/dark HTML view bundle. ``` Input (document / repo summary / PR diff / README / design doc / any technical text) ↓ analyze (this skill) core.yaml (concepts, relations, importance, difficulty, evidence, source refs) view.yaml (audience, preferred/avoided forms, density, emphasis) quiz.yaml (comprehension-check questions — default output, opt-out) ↓ design + generate (generate-explainer-html skill) HTML bundle (index.html + switchable iframe views, incl. a quiz tab) ``` ## What this skill does
Details
- Skill name
generate-explainer-yaml- Repository
- hirokita117/yaml-to-html-skill
- Path
skills/generate-explainer-yaml/SKILL.md- License
- MIT
- Repo updated
- 2 July 2026
FAQ
What does the Generate Explainer YAML skill do?
analyze a document, repository summary, pull request, README, design note, or specification and produce (or refine) the intermediate yaml files that drive the explainer pipeline — core.yaml (the semantic structure / meaning), view.yaml (the presentation strategy for a particular reader), and, by default, quiz.yaml (comprehension-check questions derived from core.yaml; skipped only when the user explicitly declines a quiz). use when the user wants to capture what a target means and how to show it before generating an html explainer, or wants to edit/reshape an existing core.yaml / view.yaml / q
How do I install the Generate Explainer YAML skill?
Claude Code plugin: /plugin marketplace add hirokita117/yaml-to-html-skill. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Generate Explainer YAML popular?
It lives in hirokita117/yaml-to-html-skill, which has 78 GitHub stars and 3 forks.
Related skills
Generate Explainer HTML
78hirokita117/yaml-to-html-skill
turn core.yaml + view.yaml (the explainer's meaning + presentation strategy) — plus quiz.yaml when present — into a self-contained html bundle that helps users understand documents, repositories, pull requests, design notes, or specifications. the bundle has a light/dark shell whose right pane switches between multiple iframe view documents, and copyable prompt templates that ask a local-file-reading ai to add another switchable view. an interactive quiz tab (comprehension check with instant grading) is added by default unless the user explicitly declines. use when the user has (or wants) a co
Memory Retrieval Learning
200lyndonkl/claude
Creates evidence-based learning plans that maximize long-term retention through spaced repetition, retrieval practice, interleaving, and elaboration. Guides through goal definition, material breakdown, review scheduling, and progress tracking. Use when long-term knowledge retention is needed, studying for exams or certifications, learning new job skills or technology, mastering substantial material, combating forgetting, or when user mentions studying, memorizing, learning plans, spaced repetition, flashcards, active recall, or durable learning.
Postmortem
200lyndonkl/claude
Conducts blameless postmortems that transform failures into learning opportunities by documenting timelines, quantifying impact, performing root cause analysis (5 Whys, fishbone diagrams), and defining corrective actions with owners and deadlines. Use when analyzing failures, outages, incidents, or negative outcomes, conducting blameless postmortems, identifying corrective actions, learning from near-misses, establishing prevention strategies, or when user mentions postmortem, incident review, failure analysis, RCA, lessons learned, or after-action review.
Autoskill
63AI-Unleashed/Claude-Skills
Analyze coding sessions to detect corrections and preferences, then propose targeted improvements to Skills used in the session. Use this skill when the user asks to "learn from this session", "update skills", or "remember this pattern". Extracts durable preferences and codifies them into the appropriate skill files.
Principle Never Block on the Human
100adriannoes/awesome-agentic-ai
Apply when tempted to ask 'should I do X?' on reversible work. Proceed, present the result, let the human course-correct after the fact; reserve confirmation for irreversible actions.
Learning Recall Call
116CALLE-AI/awesome-phone-call-agents
Conducts an authorized phone-based active recall session with a learner, asks adaptive questions about a previously studied topic, identifies knowledge gaps and misconceptions, and returns a structured learning assessment.
Browse the most popular Claude skills, all learning & education skills, or write your own with the skills generator.