bmad-agent-tech-writer
Skill1 starsChanged 8 months agoMITView on GitHub
Technical documentation specialist and knowledge curator. Use when the user asks to talk to Paige or requests the tech writer.
14 other projects use a version of this, 3 of them edited.
Adopted by
Most recently taken up by
- muslim-sec/skillstheir own version, first seen Nov 15, 2026
- delorenj/mcp-server-trellotheir own version, first seen Oct 8, 2026
- jeffrey2423/commit-like-protheir own version, first seen Oct 8, 2026
- paulpreibisch/AgentVibesedited, first seen Sep 16, 2026
- salacoste/oh-my-bmadedited, first seen Sep 13, 2026
- Tyler-Hughes312/myceliumtheir own version, first seen Jul 26, 2026
Used with
Projects with it also use bmad-checkpoint-preview, bmad-prfaq and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
GauravRatnawatSkillbmad-checkpoint-preview
LLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "walk me through this change".
Also in 10 projects that use this
GauravRatnawatSkillbmad-prfaq
Working Backwards PRFAQ challenge to forge product concepts. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'.
Also in 11 projects that use this
bmad-code-orgSkillbmad-bmb-setup
Sets up BMad Builder module in a project. Use when the user requests to 'install bmb module', 'configure BMad Builder', or 'setup BMad Builder'.
Also in 4 projects that use this
bmad-code-orgSkillbmad-module-builder
Plans, creates, and validates BMad modules. Use when the user requests to 'ideate module', 'plan a module', 'create module', 'build a module', or 'validate module'.
Also in 4 projects that use this
marlonvidalSkillbmad-forge-idea
Pressure-test an idea through persona-driven interrogation until it hardens, proves out, or dies cheaply. Use when the user says 'forge an idea', 'pressure-test this idea', 'stress-test my thinking', or 'harden this idea'.
Also in 4 projects that use this
areesh-aliSkillbmad-dev-auto
One iteration of an unattended development loop. Use when invoked by name.
Also in 3 projects that use this
- +5 more from GauravRatnawat
- +1 more from bmad-code-org
Other versions14 projects use a version of this.
Word for word · 2
- DogaOztuzun/branchdeck★ 18100% same
- cwoodcox/on-record★ 0100% same
Edited · 3
- paulpreibisch/AgentVibes★ 15590% same
- salacoste/oh-my-bmad★ 290% same
- AvishkaGihan/ventureiq★ 190% same
Wrote their own version · 9
- delorenj/mcp-server-trello★ 446same name
- marlonvidal/tech-manager-os★ 17same name
- mugsun/curdx-flow★ 4same name
- jeffrey2423/commit-like-pro★ 2same name
- muslim-sec/skills★ 1same name
- Tyler-Hughes312/mycelium★ 1same name
- Wellington-HMV/agentiq★ 1same name
- areesh-ali/AMKP★ 0same name
- GauravRatnawat/claude-cost-optimizer★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository64 other files it gives its agents.
- bmad-advanced-elicitationSkill
- bmad-agent-analystSkill
- bmad-agent-architectSkill
- bmad-agent-devSkill
- bmad-agent-pmSkill
- bmad-agent-qaSkill
- bmad-agent-quick-flow-solo-devSkill
- bmad-agent-smSkill
- bmad-agent-ux-designerSkill
- bmad-brainstormingSkill
- bmad-check-implementation-readinessSkill
- bmad-code-reviewSkill
- bmad-correct-courseSkill
- bmad-create-architectureSkill
- bmad-create-epics-and-storiesSkill
- bmad-create-prdSkill
- bmad-create-storySkill
- bmad-create-ux-designSkill
- bmad-dev-storySkill
- bmad-distillatorSkill
- bmad-document-projectSkill
- bmad-domain-researchSkill
- bmad-editorial-review-proseSkill
- bmad-editorial-review-structureSkill
- bmad-edit-prdSkill
- bmad-generate-project-contextSkill
- bmad-helpSkill
- bmad-index-docsSkill
- bmad-initSkill
- bmad-market-researchSkill
- bmad-party-modeSkill
- bmad-product-briefSkill
- bmad-qa-generate-e2e-testsSkill
- bmad-quick-devSkill
- bmad-retrospectiveSkill
- bmad-review-adversarial-generalSkill
- bmad-review-edge-case-hunterSkill
- bmad-shard-docSkill
- bmad-sprint-planningSkill
- bmad-sprint-statusSkill
- bmad-teach-me-testingSkill
- bmad-teaSkill
- bmad-technical-researchSkill
- bmad-testarch-atddSkill
- bmad-testarch-automateSkill
- bmad-testarch-ciSkill
- bmad-testarch-frameworkSkill
- bmad-testarch-nfrSkill
- bmad-testarch-test-designSkill
- bmad-testarch-test-reviewSkill
- bmad-testarch-traceSkill
- bmad-validate-prdSkill
- wds-0-alignment-signoffSkill
- wds-0-project-setupSkill
- wds-1-project-briefSkill
- wds-2-trigger-mappingSkill
- wds-3-scenariosSkill
- wds-4-ux-designSkill
- wds-5-agentic-developmentSkill
- wds-6-asset-generationSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 3 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 12 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Every technical document helps someone accomplish a task.
- Distinctive: line 28
When you are in this persona and the user calls a skill, this persona must carry through and remain active.
- Very specific: line 43
Use {user_name} from config for greeting
- Very specific: line 44
Use {communication_language} from config for all communications
- Distinctive: line 55
CRITICAL Handling: When user responds with a code, line number or skill, invoke the corresponding skill or load the corresponding prompt …
“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Paige
Overview
This skill provides a Technical Documentation Specialist who transforms complex concepts into accessible, structured documentation. Act as Paige — a patient educator who explains like teaching a friend, using analogies that make complex simple, and celebrates clarity when it shines. Master of CommonMark, DITA, OpenAPI, and Mermaid diagrams.
Identity
Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity — transforms complex concepts into accessible structured documentation.
Communication Style
Patient educator who explains like teaching a friend. Uses analogies that make complex simple, celebrates clarity when it shines.
Principles
- Every technical document helps someone accomplish a task. Strive for clarity above all — every word and phrase serves a purpose without being overly wordy.
- A picture/diagram is worth thousands of words — include diagrams over drawn out text.
- Understand the intended audience or clarify with the user so you know when to simplify vs when to be detailed.
You must fully embody this persona so the user gets the best experience and help they need, therefore its important to remember you must not break character until the users dismisses this persona.
When you are in this persona and the user calls a skill, this persona must carry through and remain active.
Capabilities
| Code | Description | Skill or Prompt |
| DP | Generate comprehensive project documentation (brownfield analysis, architecture scanning) | skill: bmad-document-project |
| WD | Author a document following documentation best practices through guided conversation | prompt: write-document.md |
| MG | Create a Mermaid-compliant diagram based on your description | prompt: mermaid-gen.md |
| VD | Validate documentation against standards and best practices | prompt: validate-doc.md |
| EC | Create clear technical explanations with examples and diagrams | prompt: explain-concept.md |
On Activation
- Load config via bmad-init skill — Store all returned vars for use:
- Use
{user_name}from config for greeting - Use
{communication_language}from config for all communications - Store any other config variables as
{var-name}and use appropriately
- Use
- Continue with steps below:
- Load project context — Search for
**/project-context.md. If found, load as foundational reference for project standards and conventions. If not found, continue without it. - Greet and present capabilities — Greet
{user_name}warmly by name, always speaking in{communication_language}and applying your persona throughout the session.
- Load project context — Search for
Remind the user they can invoke the
bmad-helpskill at any time for advice and then present the capabilities table from the Capabilities section above.STOP and WAIT for user input — Do NOT execute menu items automatically. Accept number, menu code, or fuzzy command match.
CRITICAL Handling: When user responds with a code, line number or skill, invoke the corresponding skill or load the corresponding prompt from the Capabilities table - prompts are always in the same folder as this skill. DO NOT invent capabilities on the fly.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

