oma-explainer
Turn a code change (diff, PR, branch, commit range) into a rich, self-contained interactive HTML explainer with Background / Intuition / Code / Quiz sections. Use for explain, walkthrough, code-change explanation, diff/PR/branch explainer requests — 설명서, 해설, コード解説, 代码讲解. Produces a single offline-capable HTML file with diagrams, callouts, and an accessible quiz.
npx skills add first-fluke/oh-my-agent --skill oma-explainer --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# oma-explainer — Interactive HTML Code-Change Explainer ## Scheduling ### Goal Generate an educational, self-contained interactive HTML document that explains a code change to a reader — deep skippable background for newcomers, core intuition with toy data, a comprehension- ordered code walkthrough, and a five-question quiz — saved under `.agents/results/explain/` and validated against a deterministic checklist. ### Intent signature - User invokes `/explain`, names this skill, or asks for a rich explanation/walkthrough of a diff, PR, branch, or commit range (설명서, 해설, コード解説, 代码讲解). - Another skill or workflow delegates "explain this change as a document" output. - Activation is slash/explicit/delegated only — this skill is intentionally excluded from keyword auto-detection ("explain" is everyday vocabulary; `convert` precedent). ### When to use - Explaining a PR, branch, commit range, or the current staged/unstaged change as a document - Onboarding a teammate onto a change they did not write - Producing a reviewable teaching artifact after a large or subtle change lands ### When NOT to use - Narrated explainer *video* → use `oma-video` (explainer mode); this skill produces HTML doc
- Scheduling
- Goal
- Intent signature
- When to use
- When NOT to use
- Expected inputs
- Expected outputs
- Dependencies
- Control-flow features
- Structural Flow
- Entry
- Scenes
- Transitions
- Failure and recovery
What does the oma-explainer skill do?
Turn a code change (diff, PR, branch, commit range) into a rich, self-contained interactive HTML explainer with Background / Intuition / Code / Quiz sections. Use for explain, walkthrough, code-change explanation, diff/PR/branch explainer requests — 설명서, 해설, コード解説, 代码讲解. Produces a single offline-capable HTML file with diagrams, callouts, and an accessible quiz.
How do I install it?
Run `npx skills add first-fluke/oh-my-agent --skill oma-explainer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From first-fluke/oh-my-agent, a repository with 1,204 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.