Markdown Report Writing
NeuroAIHub/BrainPilot
Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian.
Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with…
$ npx skills add digoal/blog --skill axiom-explainer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog axiom-explainer --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/axiom-explainer .claude/skills/axiom-explainer && 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 "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .claude/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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/digoal/blog/tree/master/skills/axiom-explainerType 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 digoal/blog --skill axiom-explainer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog axiom-explainer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/axiom-explainer .agents/skills/axiom-explainer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .agents/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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 digoal/blog --skill axiom-explainer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog axiom-explainer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/axiom-explainer .cursor/skills/axiom-explainer && 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 "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .cursor/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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/digoal/blog.git --path skills/axiom-explainer--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 digoal/blog --skill axiom-explainer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog axiom-explainer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/axiom-explainer .gemini/skills/axiom-explainer && 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 "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .gemini/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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 digoal/blog axiom-explainerInstalls 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 digoal/blog --skill axiom-explainer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/axiom-explainer .github/skills/axiom-explainer && 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 "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .github/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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 digoal/blog --skill axiom-explainer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install digoal/blog axiom-explainer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/axiom-explainer .opencode/skills/axiom-explainer && 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 "axiom-explainer" agent skill from https://github.com/digoal/blog/tree/master/skills/axiom-explainer into .opencode/skills/axiom-explainer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "axiom-explainer", 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.
axiom-explainerWrite Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with…
Axiom Explainer is an agent skill from digoal/blog. Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with text/Mermaid and standalone GitHub-renderable SVG files, assumptions, derivation or motivation, applicability boundaries, positive and negative examples, and save the result under the current project's markdown directory. Use when Codex is asked to generate 公理讲解文案、定理讲解、理论体系通俗解读、观点拆解、面向大学生和成年人的图文并茂 Markdown 文章.
Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `agents/openai.yaml` and `test-prompts.json`).
It sits in Documents & Office, covering Diagrams and Markdown. It works with GitHub and Mermaid. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit ad6fcb7. It shows what the files ask for, not the result of running them.
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.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and mermaid).
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
w3.orgFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Axiom Explainer loads about 3.6k tokens when it runs. Until then it costs about 131 tokens; SKILL.md has 1,804 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.
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.
The full file from digoal/blog at commit ad6fcb7, republished under its GPL-2.0 licence (© digoal). 1,804 words, ~3,647 tokens.
.claude/skills/axiom-explainer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.Generate a clear Chinese teaching article for university students and adults with social experience from a single viewpoint, axiom, theorem, law, principle, or theory system. The output must be Markdown, visually rich, and saved under the current project's markdown/ directory.
Required input:
Optional input:
If the user gives several concepts, choose the central one only when the concepts clearly form one theory chain. Otherwise ask the user to pick one concept before writing.
Identify the input type:
Scope the audience:
Verify the concept:
🔴 CHECKPOINT: Before writing the article, confirm these internal decisions: input type, chosen version, audience level, central question, and the 3-5 named assumptions or boundaries. If any item is unclear and cannot be resolved from the user's prompt or reliable references, ask one concise clarification question.
Write this decision sheet before drafting, then use it as the article's control plan:
| Item | Required content |
|---|---|
| Input type | One of: axiom/postulate, theorem/proposition, viewpoint/law/principle, theory system |
| Chosen version | Exact statement or named version being explained; mark "standard textbook version" or "user-supplied wording" when no narrower source is available |
| Central question | One sentence in the reader's language, not a broad topic label |
| Assumptions and boundaries | 3-5 named premises, each with "成立时" and "不成立时" consequences |
| Evidence or derivation route | For axioms: motivation/model/independence route; for theorems: definition -> lemma -> conclusion route; for viewpoints: claim -> evidence -> counterevidence route |
| Visual plan | Mermaid purpose, SVG purpose, and table/TXT/second-SVG purpose; each must map to one assumption, mechanism, proof step, or failure boundary |
Create visuals:
Write and save:
markdown/ in the current project if it does not exist.markdown/YYYYMMDD-<topic-slug>.md.markdown/assets/<topic-slug>/..🔴 CHECKPOINT: Before saving the final Markdown, run this quality gate. If any row fails, revise the article or asset before responding.
| Gate | Pass condition |
|---|---|
| Concept control | The article explains one target concept, or explicitly states why several concepts form one theory chain |
| 求真/求存 separation | "求真讲法" explains truth, acceptance, proof, derivation, or evidence; "求存讲法" explains use, transfer, boundary, and decision value |
| Assumption linkage | Every positive example and negative example names the assumption or boundary that makes it work or fail |
| Visual usefulness | Mermaid, SVG, and the additional visual each teach a different mechanism, boundary, proof step, or comparison |
| Asset integrity | Every SVG file exists under markdown/assets/<topic-slug>/, has a valid <svg xmlns="http://www.w3.org/2000/svg" viewBox="...">, and is referenced with a relative path |
| Source honesty | References distinguish user-supplied material, textbook/common knowledge, web-verified sources, and unverified claims |
| Trigger | First action | Fallback if still unresolved |
|---|---|---|
| Topic is too broad, such as "explain economics" or "explain mathematics" | Narrow it to one named concept in one sentence and ask the user to confirm | If the user wants a broad overview, write a map article and clearly mark that it is not a deep axiom/theorem explanation |
| The statement has multiple versions or disputed wording | Name the selected version and cite the basis for choosing it | Add a "版本差异" paragraph and explain only the version used in the article |
| The proof, history, or attribution is uncertain | Use cautious wording and verify with reliable references | Omit the uncertain story or proof detail; explain the intuition and state what remains unverified |
| Network or source access is unavailable | Use known textbook-level knowledge and mark "未联网核验" in references | Avoid dates, quotations, origin stories, and named attributions that depend on fresh verification |
| The concept is advanced for the requested audience | Use analogy and intuition first, then a small formal skeleton | Move advanced proof details to "进一步学习", and do not pretend the full proof was shown |
| The requested format conflicts with required parts | Preserve 求真讲法, 求存讲法, and 思考 as sections or clearly named equivalents | If the conflict is explicit, follow the user format but mention which required parts were mapped where |
| The visual plan cannot be made meaningful | Replace the weak visual with a table, boundary diagram, proof skeleton, set relation, timeline, or counterexample map tied to a named assumption | If only one meaningful visual exists, keep it and state why the extra visual requirement would be decorative |
| SVG creation or validation fails | Repair the SVG syntax, escape special characters, and re-check the relative Markdown link | Fall back to one valid SVG plus a Markdown table; report the limitation in the final summary |
| References cannot verify an attribution or quote | Remove the attribution or quote and explain the concept without it | Mark the claim as "未联网核验" only when the claim is not central to the explanation |
Use this structure unless the user asks for a different format:
# <主题>: 一句话讲透
> 面向对象: <大学生及有一定社会阅历的成年人>
> 核心问题: <这篇文章要解决的困惑>
> 先说结论: <用一两句话说清楚它到底是什么>
## 一张图先看懂
<Mermaid 概念图、推导图、边界图或迁移图>

## 求真讲法
### 它到底说了什么
<用受过高等教育或有现实经验的成年人能听懂的语言重述>
### 它是怎么来的
<公理讲动机和选择理由;定理讲推导链;观点讲证据链>
### 它依赖哪些假设
<列出前提、定义、理想化条件、隐含边界>
### 常见误解
<说明哪些说法看似相近但其实不对>
## 求存讲法
### 它有什么用
<原生领域的作用>
### 它怎么迁移到熟悉领域
<从诞生领域迁移到学习、工作、生活、管理、技术或商业等领域>
### 它的适用范围和边界
<说明什么条件下有效,什么条件下不能乱用>
### 正例: 怎么用它提升能力
<优先使用投资理财、产品经理、产品运营、营销、人际交往或职场中的可操作例子>
### 反例: 前提不成立会怎样
<优先使用投资理财、产品经理、产品运营、营销、人际交往或职场中的失败例子,突出逻辑判断和洞察>
## 思考
<发人深省的拓展问题、反事实设问、跨学科联系>
## 最后记住
<3-5 条可复述要点>
## 参考资料
<列出参考来源;没有联网时说明基于通用知识和已知教材体系>Do not:
file:// URLs, remote placeholder URLs, or paths outside markdown/assets/<topic-slug>/.Use diagrams as teaching tools:
flowchart LR
A["前提假设"] --> B["推导/选择理由"]
B --> C["结论"]
C --> D["可迁移应用"]
A -. "不成立" .-> E["反例/失效边界"]Useful visual patterns:
SVG file rules:
markdown/assets/<topic-slug>/ before writing SVG files.assumption-boundary.svg or proof-chain.svg.<svg xmlns="http://www.w3.org/2000/svg" viewBox="...">, embedded text, shapes, labels, and arrows; do not depend on external fonts, CSS, scripts, or remote images.viewBox; avoid fixed tiny canvases.&, <, and >..Do not add fake image URLs. If using an external image, cite its source and make sure it directly supports the explanation.
Before finishing, verify:
markdown/ directory.markdown/assets/<topic-slug>/ and referenced from the article with relative links.求真讲法, 求存讲法, and 思考.© digoal, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files in skills/axiom-explainer of digoal/blog.
Open the folder on GitHubat commit ad6fcb7
Axiom Explainer 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 |
|---|---|---|---|---|---|---|
| Axiom Explainer this skilldigoal/blog | 8.6k | — | ~3.6k | Automated safety check: Pass | GPL-2.0 | |
| Markdown Report WritingNeuroAIHub/BrainPilot | 1.1k | — | ~2.6k | Automated safety check: Warn | AGPL-3.0 | |
| Markdown Syntax Guideantdigital-ai/agentic-ui | 224 | — | ~3.1k | Automated safety check: Pass | MIT | |
| Bm Mdmiantiao-me/bm.md | 617 | — | ~2.1k | Automated safety check: Pass | LGPL-3.0 | |
| Chatbot Mvp Distillationpdsuwwz/chatgpt-vue3-light-mvp | 578 | — | ~722 | Automated safety check: Pass | MIT | |
| Chatbot Mvp Distillation Zhpdsuwwz/chatgpt-vue3-light-mvp | 578 | — | ~414 | Automated safety check: Pass | MIT |
NeuroAIHub/BrainPilot
Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian.
antdigital-ai/agentic-ui
指导用户使用 @ant-design/agentic-ui 的 Markdown Editor / Renderer 扩展语法。图表场景优先使用内置 chart(HTML 注释 chartType + 表格),只有当内置 chartType 都不能表达诉求时才回退 Mermaid。Triggers on keywords like 表格, 视频, 图表, 卡片, 提示块, 流程图, 语法…
miantiao-me/bm.md
使用 bm.md 写作、改写、排版或渲染 Markdown;生成 Mermaid 与 AntV Infographic,设置图片尺寸、高亮重点,以及执行 HTML/纯文本转换和 Markdown lint
pdsuwwz/chatgpt-vue3-light-mvp
Distill the chatgpt-vue3-light-mvp project into reusable architecture for building similar ChatGPT-style web products in other repositories.
pdsuwwz/chatgpt-vue3-light-mvp
将 chatgpt-vue3-light-mvp 项目蒸馏为可迁移到其他项目的中文架构指南。适用于设计或实现类似 ChatGPT 的 Web 对话产品,包括 SSE/fetch 流式响应、模型适配器契约、打字机渲染、Markdown/代码/KaTeX/Mermaid 渲染、推理过程展示,以及从本 Vue 3 MVP 迁移到其他项目的方案规划。
K-Dense-AI/scientific-agent-skills
Writes scientific Markdown documentation and Mermaid diagrams for workflows, relationships, timelines, and schemas.
digoal/blog
三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…
digoal/blog
Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…
digoal/blog
Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…
digoal/blog
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…
digoal/blog
Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…
digoal/blog
Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.
Categories
Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with…. Axiom Explainer is an agent skill from digoal/blog. Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with text/Mermaid and standalone GitHub-renderable SVG files, assumptions, derivation or motivation, applicability boundaries, positive and negative examples, and save the result under the current project's markdown directory.
Axiom Explainer fits situations like: Codex is asked to generate 公理讲解文案、定理讲解、理论体系通俗解读、观点拆解、面向大学生和成年人的图文并茂 Markdown 文章; tasks that involve Diagrams; tasks that involve Markdown.
Run `npx skills add digoal/blog --skill axiom-explainer -a claude-code`. Or copy the skill folder (skills/axiom-explainer in digoal/blog) into .claude/skills/axiom-explainer in your project. Claude Code loads it when a task matches its description.
Run `npx skills add digoal/blog --skill axiom-explainer -a codex`. Or copy the skill folder (skills/axiom-explainer in digoal/blog) into .agents/skills/axiom-explainer in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add digoal/blog --skill axiom-explainer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/axiom-explainer, .gemini/skills/axiom-explainer, .github/skills/axiom-explainer and .opencode/skills/axiom-explainer in your project.
SKILL.md names no scripts, command-line tools or credentials: Axiom Explainer is instructions for the agent only.
SKILL.md names 1 domain. In commands or code: w3.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
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.
Axiom Explainer is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.6k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Axiom Explainer: Markdown Report Writing (NeuroAIHub/BrainPilot, 1.1k stars), Markdown Syntax Guide (antdigital-ai/agentic-ui, 224 stars), Bm Md (miantiao-me/bm.md, 617 stars) and Chatbot Mvp Distillation (pdsuwwz/chatgpt-vue3-light-mvp, 578 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
digoal (a GitHub user) maintains it in digoal/blog, which has 8,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 2026.
Source: digoal/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.