- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add first-fluke/oh-my-agent --skill oma-explanation -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/first-fluke/oh-my-agent/tree/HEAD/.agents/skills/oma-explanationDel publicador
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.mdPreguntas frecuentes
Descarga .agents/skills/oma-explanation/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/first-fluke/oh-my-agent.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.