- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/first-fluke/oh-my-agent/tree/HEAD/.agents/skills/oma-explanationTừ nhà phát hành
Generate an educational, self-contained interactive HTML document, saved under
.agents/results/explain/ and validated with oma explain validate. Two modes:
In both modes the model writes a Markdown draft and oma explain render produces the HTML.
Layout, theme, diagram geometry, and the quiz script are the renderer's, not the model's.
/explain, names this skill, or asks for a rich explanation/walkthrough of a
diff, PR, branch, or commit range (설명서, 해설, コード解説, 代码讲解)./explain how does the row planner work)./explain workflow starts from its slash command only. The skill hint matches
explainer-specific phrases ("html explainer", "walkthrough document"); the bare word
"explain" is everyday vocabulary and never selects this skill.oma-video (explainer mode); this skill produces HTML documentsoma-docs (drift detection)oma-slide (fixed 1920×1080 deck contract)oma-qa (or the review workflow); this
skill narrates a change educationally, it does not evaluate ittopic when the request names a subject and no ref resolves from it; otherwise
change. An explicit ref always means change mode.#640, via gh pr diff), branch (git diff main...{branch}),
or SHA range (a..b / a...b)git diff --cached)git diff)HEAD~1..HEADonboarding (default — full deep background) | reviewer (condensed background).agents/oma-config.yaml language → en.
Prose and quiz in the user's language; code, identifiers, and inline code always English..agents/results/explain/{YYYY-MM-DD}-{slug}.html
(date in oma-config timezone, else the system timezone; same date + slug rerun overwrites).oma explain render --open (a failed open is not a failure).{YYYY-MM-DD}-{slug}.archify.html (+ .archify.json) linked from the
explainer by a plain anchor, when diagram.explain_sidecar is on or the user asks and
oma diagram resolve reports engine: archify. Never embedded — the self-contained contract holds.outputs:
- name: explainer-html
description: Self-contained interactive HTML explainer (Background/Intuition/Code/Quiz)
artifact: ".agents/results/explain/*.html"
required: true
- name: explainer-archify-sidecar
description: Optional archify interactive diagram sidecar next to the explainer
artifact: ".agents/results/explain/*.archify.html"
required: false
resources/draft-format.md — the draft you write and the oma explain render commandsresources/document-structure.md — WHAT a change explainer contains (sections, diagrams, style)resources/html-contract.md — HOW the HTML is validated (oma explain validate, secret gates)
and, for hand-written HTML only, how it must behave (self-contained rules, quiz JS)git; optional gh CLI for PR refs_shared/conditional/diagram-engine.md + oma diagram resolve for the opt-in archify sidecarcode_intelligence capability for surrounding-code exploration; native search is only for paths outside this project or ignored paths when it is unavailable or times out.oma explain render | lint | components | patch | validatereviewer level → condense Background tier A; keep Intuition/Code full.style: off.gh missing or unauthenticated → give install/auth guidance + local branch-diff alternative.--open in a headless environment) → not a failure; the reported path suffices.Driven end-to-end by .agents/workflows/explain.md (slash-only; disable-model-invocation: true).
resources/draft-format.md before generating. In change mode also read
resources/document-structure.md (its §1 and §6 markup rules bind only hand-written HTML)
and resources/html-contract.md §6–§7 (validation, secret gates). Read html-contract.md
§1–§5 only when the hand-written HTML fallback is taken.code_intelligence capability. If it is unavailable or times out, use native search only
for paths outside this project or ignored paths and record that limit. A change-mode diff
must be explainable: non-empty, not binary-only, not generated-only or version-bump-only
(see the predicate in .agents/workflows/explain.md Step 1); otherwise stop per Failure
and recovery.draft-format.md and run oma explain render.
Change mode: Background (two tiers), Intuition (toy data + diagrams), Code walkthrough
(comprehension order), Quiz, as panels in that order, with template: doc (linear, with
contents). Topic mode: lead answer, then 4–9 panels, one idea each, a diagram wherever a
relation or a sequence is the point; template: sheet for an overview, doc for a
walkthrough.
Hand-written HTML is a fallback only for content no component can express; say so in
the report.oma explain validate <file> and the final-HTML secret scan from
html-contract.md §6–§7; its grep commands are supplemental spot checks, not a
substitute. A secret hit is handled as in step 4. Fix → re-validate, max 3 iterations;
then surface failures and stop..agents/results/explain/{YYYY-MM-DD}-{slug}.html. Open it
by rendering the validated draft with --open (a failed open is not a failure), then
report TL;DR + path. The archify sidecar comes from the
same render: --archify (or diagram.explain_sidecar) derives the spec from the
{archify} panel's flow/sequence block, delivers it, and links it. Report the sidecar
status the command prints. A sidecar failure never blocks delivery..agents/results/explain/, plus the .archify.html and
.archify.json sidecar files when the opt-in sidecar is built.git, gh, and oma explain subprocesses. Opens the page in the browser through
oma explain render --open (local OS side effect; a failed open is not a failure).gh pr diff (GitHub API, read-only) only when a PR ref is requested; no network
writes.gh auth token if configured; no other secrets handled.resources/draft-format.md — draft syntax, components, writing rules, sidecarresources/document-structure.md — change-explainer content contractresources/html-contract.md — validation and secret gates (§6–§7); hand-written HTML rules (§1–§5)Create an offline HTML explanation of a code change (diff, PR, branch) or of a topic, system, or question. Use when a visual walkthrough document is requested.
---name: oma-explanationdescription: Create an offline HTML explanation of a code change (diff, PR, branch) or of a topic, system, or question. Use…---# .agents/skills/oma-explanation/SKILL.mdCâu hỏi thường gặp
Tải .agents/skills/oma-explanation/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/first-fluke/oh-my-agent.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.