Archify Diagrams
tt-a1i/archify
Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.
Conventions for writing a Markdown explainer that walks the reader through a concept or system.
Install Explain
$ npx skills add mathbullet/skills --skill explain -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mathbullet/skills explain --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/explain/skills/explain .claude/skills/explain && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .claude/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explainType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mathbullet/skills --skill explain -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mathbullet/skills explain --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/explain/skills/explain .agents/skills/explain && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .agents/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mathbullet/skills --skill explain -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mathbullet/skills explain --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/explain/skills/explain .cursor/skills/explain && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .cursor/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mathbullet/skills.git --path plugins/explain/skills/explain--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mathbullet/skills --skill explain -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mathbullet/skills explain --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/explain/skills/explain .gemini/skills/explain && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .gemini/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mathbullet/skills explainInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mathbullet/skills --skill explain -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/explain/skills/explain .github/skills/explain && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .github/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mathbullet/skills --skill explain -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mathbullet/skills explain --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/explain/skills/explain .opencode/skills/explain && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/mathbullet/skills/tree/main/plugins/explain/skills/explain into .opencode/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
explain- GitHub stars
- 172
- Token cost
- ~659 tokens
- SKILL.md length
- 364 words
- Files
- 1
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- MIT
At a glance
Conventions for writing a Markdown explainer that walks the reader through a concept or system.
- Works in 5 steps: Term list → Background (why this thing is necessary,… → Mechanism (how it works — includes the… → …
- The user asks for an explainer
- SKILL.md covers Term handling, Diagram conventions, Granularity of the description and Structure
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Explain is an agent skill from mathbullet/skills. Conventions for writing a Markdown explainer that walks the reader through a concept or system. Lays out term-list formatting, Mermaid diagram rules, granularity expectations, and a fixed five-part structure. Use when the user asks for an explainer, a concept write-up, a glossary section, or otherwise wants a system or idea documented for another reader.
Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development. It works with Mermaid. The repository describes itself as: mathbullet Agent Skills. The licence is MIT.
When your agent uses it
- The user asks for an explainer
- A concept write-up
- A glossary section
- Otherwise wants a system
Example prompts
- “Use the explain skill to convention for writing a Markdown explainer that walks the reader through a concept or system”
- “/explain”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Term list
- Background (why this thing is necessary, or what problem it addresses)
- Mechanism (how it works — includes the diagrams)
- Concrete steps (commands, procedures, or worked examples)
- Current state (where things stand today — for ongoing systems)
What it can do on your machine
Read from SKILL.md and the folder at commit 5ab997f. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Explain loads about 659 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 364 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from mathbullet/skills at commit 5ab997f, republished under its MIT licence (© mathbullet). 364 words, ~659 tokens.
Download SKILL.mdSave it as
.claude/skills/explain/SKILL.md (or your agent's skills folder).- name
- explain
- description
- Conventions for writing a Markdown explainer that walks the reader through a concept or system. Lays out term-list formatting, Mermaid diagram rules, granularity expectations, and a fixed five-part structure. Use when the user asks for an explainer, a concept write-up, a glossary section, or otherwise wants a system or idea documented for another reader.
Explainer Document Conventions
Term handling
- Put a term list at the top of the document in table form (
| Term | Description |). Every specialised term used in the body must be defined in this list at first occurrence. - A term-list entry defines what the term is in one or two sentences. The functional or behavioural detail goes in the body, not in the term list.
- Even widely recognised proper nouns (industry-standard product names, infrastructure components, etc.) get defined here. Assume the reader does not know them.
- When defining a compound term, define the constituent words too. If the compound has three words, give all three their own entries — readers cannot be expected to infer one from another.
Diagram conventions
- Use Mermaid for diagrams. Do not use ASCII art.
- Every node label is a term that exists in the term list. Do not introduce a new term inside a diagram.
- Do not put
<br/>inside a Mermaid node. Many renderers display the literal HTML tag. If a line break is needed, separate with/or shorten the text to fit one line. - For diagrams with four or more nodes, or where any label is long, use
graph TD(top-down).graph LR(left-right) collapses long-label graphs into an unreadable horizontal strip.
Show full SKILL.md (158 more words)Show less
Granularity of the description
- Do not gloss details with vague language. Subjects, objects, and verbs must be explicit.
- A phrase like "A uses B to do X" must specify what A is and why A is needed for X.
- Avoid vague verbs like "receives" or "passes". Spell out who does what to bring the state about (e.g. "receives the address" → "the platform allocates the address automatically").
- Do not require the reader to make a leap between steps. Every step's causal connection to the next is explicit.
- Describe the mechanism in its general form first; tie it to specific named instances afterwards as "in case X, ...". Do not anchor the whole description to a single proper-noun example.
Structure
- Term list
- Background (why this thing is necessary, or what problem it addresses)
- Mechanism (how it works — includes the diagrams)
- Concrete steps (commands, procedures, or worked examples)
- Current state (where things stand today — for ongoing systems)
© mathbullet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in plugins/explain/skills/explain of mathbullet/skills.
Open the folder on GitHubat commit 5ab997f
Compare with similar skills
Explain next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Explain this skillmathbullet/skills | 172 | — | ~659 | Automated safety check: Pass | MIT | |
| Archify Diagramstt-a1i/archify | 79k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Diagram Designcathrynlavery/diagram-design | 44k | 1 repos | ~7.5k | Automated safety check: Pass | MIT | |
| Draw.io Diagram StudioAgents365-ai/drawio-skill | 10k | — | ~2.4k | Automated safety check: Notes | MIT | |
| Pretty Mermaid Rendererimxv/Pretty-mermaid-skills | 1.5k | — | ~2k | Automated safety check: Pass | MIT | |
| Archify Diagram BuilderUnclecheng-li/AI_Animation | 1.4k | 2 repos | ~4.1k | Automated safety check: Pass | MIT |
Similar skills
Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
Draw.io Diagram Studio
Agents365-ai/drawio-skill
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
Pretty Mermaid Renderer
imxv/Pretty-mermaid-skills
Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.
Archify Diagram Builder
Unclecheng-li/AI_Animation
Builds validated architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone interactive HTML from a small JSON spec, with optional motion and image export.
Mermaid
WH-2099/mermaid-skill
Generate Mermaid diagrams from user requirements. An agent skill from WH-2099/mermaid-skill.
More from mathbullet/skills
All 8 skills in this repoPaper Details
mathbullet/skills
Produce a detailed Markdown explainer of an academic paper. An agent skill from mathbullet/skills.
Survey
mathbullet/skills
Investigate a topic across papers, articles, social-media posts, and industry signals, then deliver an indexed Markdown report.
Grilling Viz
mathbullet/skills
grilling による質問を、選択肢と自由入力でまとめて回答し、コピーできるHTMLにする. An agent skill from mathbullet/skills.
HTML
mathbullet/skills
概念・仕組み・調査内容を、HTML による視覚的な説明ドキュメントとして作成・編集する. An agent skill from mathbullet/skills.
Writing Quotation
mathbullet/skills
Formatting rules for quoting external sources (papers, articles, web pages, prompt templates) inside a Markdown document.
Documenting With Sources
mathbullet/skills
Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside).
Related
Works with
Categories
Questions about Explain
What does Explain do?
Conventions for writing a Markdown explainer that walks the reader through a concept or system. Explain is an agent skill from mathbullet/skills. Conventions for writing a Markdown explainer that walks the reader through a concept or system.
When should I use Explain?
Explain fits situations like: the user asks for an explainer; A concept write-up; A glossary section; otherwise wants a system.
How do I install Explain in Claude Code?
Run `npx skills add mathbullet/skills --skill explain -a claude-code`. Or copy the skill folder (plugins/explain/skills/explain in mathbullet/skills) into .claude/skills/explain in your project. Claude Code loads it when a task matches its description.
How do I install Explain in Codex?
Run `npx skills add mathbullet/skills --skill explain -a codex`. Or copy the skill folder (plugins/explain/skills/explain in mathbullet/skills) into .agents/skills/explain in your project. Codex loads it when a task matches its description.
Can I use Explain in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mathbullet/skills --skill explain -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/explain, .gemini/skills/explain, .github/skills/explain and .opencode/skills/explain in your project.
What does Explain need to run?
SKILL.md names no scripts, command-line tools or credentials: Explain is instructions for the agent only.
Does Explain access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Explain safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Explain use?
Explain is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Explain use?
About 659 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Explain?
Skills that share tags, products or a category with Explain: Archify Diagrams (tt-a1i/archify, 79k stars), Diagram Design (cathrynlavery/diagram-design, 44k stars), Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars) and Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Explain?
mathbullet (a GitHub user) maintains it in mathbullet/skills, which has 172 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 9, 2026.
Source: mathbullet/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.