Markdown Mermaid Writing
neflibata-feng/MyArxiv-Agent
Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard.
Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity.
$ npx skills add digoal/blog --skill write-brd -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog write-brd --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/write-brd .claude/skills/write-brd && 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 "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .claude/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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/write-brdType 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 write-brd -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog write-brd --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/write-brd .agents/skills/write-brd && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .agents/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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 write-brd -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog write-brd --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/write-brd .cursor/skills/write-brd && 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 "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .cursor/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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/write-brd--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 write-brd -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog write-brd --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/write-brd .gemini/skills/write-brd && 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 "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .gemini/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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 write-brdInstalls 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 write-brd -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/write-brd .github/skills/write-brd && 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 "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .github/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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 write-brd -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 write-brd --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/write-brd .opencode/skills/write-brd && 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 "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/write-brd into .opencode/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", 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.
write-brdWrite a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity.
Write Brd is an agent skill from digoal/blog. Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, generate, refine, or save a BRD/business requirements document/product business case in Markdown, especially when the output should be saved under the current project's markdown directory and include diagrams using Mermaid, SVG, or ASCII.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `agents/openai.yaml`, `assets/brd-template.md` and `references/brd-writing-guide.md`).
It sits in Development, covering Diagrams, PRD writing and Markdown. It works with 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.
7 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 69fb793. 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.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From 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.
Write Brd loads about 1.4k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 749 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 69fb793, republished under its GPL-2.0 licence (© digoal). 749 words, ~1,445 tokens.
.claude/skills/write-brd/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.Turn a rough product idea into a decision-ready BRD Markdown file saved in the current project's markdown/ directory. The BRD should help stakeholders decide whether to invest, what user problem is real, what scope is in or out, and how success will be verified after launch.
This skill writes BRDs, not PRDs. Keep implementation detail high enough for feasibility and handoff, but do not expand into screen-by-screen product specs unless the user asks.
markdown/<topic>-BRD-<YYYYMMDD>.md.markdown/ directory, named figure-1-<topic>-BRD-<YYYYMMDD>.svg, then reference it from the Markdown with .If the user's idea is too thin to write a credible BRD, ask at most 3 questions. Prefer assumptions over long interrogation.
Ask only for missing information that changes the BRD materially:
If the user gives no detail beyond an idea, proceed with explicit assumptions and mark low-confidence sections.
Before writing sections, convert the idea into this chain:
business loss/opportunity -> target user -> current workaround -> proposed capability -> success metric -> delivery boundary -> stop/continue ruleReject pure feature-first framing. Do not start the BRD from "we need feature X" unless you immediately explain why the business should fund it.
Use these lenses in every BRD:
Read assets/brd-template.md when drafting the document. Adapt headings to the user's context, but keep the core decision logic intact.
For extra guidance on evidence, diagrams, validation, and wording, read references/brd-writing-guide.md.
Every BRD must include at least one diagram that supports reasoning, not decoration. Good diagram choices:
Use Mermaid unless SVG is clearly better. If using SVG, create a standalone SVG file and reference it in Markdown.
Every BRD must include:
Do not let "launch completed" stand in for "business value achieved".
After writing the Markdown file:
markdown/ directory.If adapting the template, keep these sections at minimum:
© 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 3 other files (references, assets) in skills/write-brd of digoal/blog.
Open the folder on GitHubat commit 69fb793
Write Brd 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 |
|---|---|---|---|---|---|---|
| Write Brd this skilldigoal/blog | 8.6k | — | ~1.4k | Automated safety check: Pass | GPL-2.0 | |
| Markdown Mermaid Writingneflibata-feng/MyArxiv-Agent | 126 | 5 repos | ~3.8k | Automated safety check: Notes | Apache-2.0 | |
| Design Decknicobailon/pi-design-deck | 291 | — | ~4.3k | Automated safety check: Pass | None | |
| 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 | |
| Markdown Mermaid WritingK-Dense-AI/scientific-agent-skills | 48k | 1 repos | ~4.2k | Automated safety check: Notes | Apache-2.0 |
neflibata-feng/MyArxiv-Agent
Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard.
nicobailon/pi-design-deck
Present visual options for architecture, UI, and code decisions with high-fidelity side-by-side previews.
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.
github/awesome-copilot
A skill your agent uses when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including…
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.
Works with
Categories
Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Write Brd is an agent skill from digoal/blog. Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity.
Write Brd fits situations like: the user asks to write; save a BRD/business requirements document/product business case in Markdown; especially when the output should be saved under the current projects markdown directory and include diagrams using Mermaid.
Run `npx skills add digoal/blog --skill write-brd -a claude-code`. Or copy the skill folder (skills/write-brd in digoal/blog) into .claude/skills/write-brd in your project. Claude Code loads it when a task matches its description.
Run `npx skills add digoal/blog --skill write-brd -a codex`. Or copy the skill folder (skills/write-brd in digoal/blog) into .agents/skills/write-brd 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 write-brd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/write-brd, .gemini/skills/write-brd, .github/skills/write-brd and .opencode/skills/write-brd in your project.
SKILL.md names no scripts, command-line tools or credentials: Write Brd is instructions for the agent only.
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.
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.
Write Brd 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 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Write Brd: Markdown Mermaid Writing (neflibata-feng/MyArxiv-Agent, 126 stars), Design Deck (nicobailon/pi-design-deck, 291 stars), Chatbot Mvp Distillation (pdsuwwz/chatgpt-vue3-light-mvp, 578 stars) and Chatbot Mvp Distillation Zh (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,587 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 28, 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.