Agent skill

Bmad Agent Tech Writer

by delorenj in delorenj/mcp-server-trello

Technical documentation specialist and knowledge curator. An agent skill from delorenj/mcp-server-trello.

MITAuto-check passedDevelopment

Install Bmad Agent Tech Writer

skills CLI
$ npx skills add delorenj/mcp-server-trello --skill bmad-agent-tech-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install delorenj/mcp-server-trello bmad-agent-tech-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/delorenj/mcp-server-trello.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agent/skills/bmad-agent-tech-writer .claude/skills/bmad-agent-tech-writer && rm -rf skills-src

Use ~/.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/

Facts

Skill name
bmad-agent-tech-writer
GitHub stars
445
Used in
4 other repos
Token cost
~1.1k tokens
SKILL.md length
584 words
Files
6
Skills in repo
64
Repo updated
First seen
Licence
MIT

At a glance

Technical documentation specialist and knowledge curator. An agent skill from delorenj/mcp-server-trello.

  • Works in 8 steps: Resolve the Agent Block → Execute Prepend Steps → Adopt Persona → …
  • The user asks to talk to Paige
  • SKILL.md covers Overview, Conventions and On Activation
  • Calls python3

What it does

Bmad Agent Tech Writer is an agent skill from delorenj/mcp-server-trello. Technical documentation specialist and knowledge curator. Use when the user asks to talk to Paige or requests the tech writer.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `explain-concept.md`, `mermaid-gen.md` and `validate-doc.md`).

It sits in Development, covering Technical documentation and Technical writing. The repository describes itself as: A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. The licence is MIT.

When your agent uses it

  • The user asks to talk to Paige
  • Requests the tech writer

Example prompts

  • “/bmad-agent-tech-writer”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Resolve the Agent Block
  2. Execute Prepend Steps
  3. Adopt Persona
  4. Load Persistent Facts
  5. Load Config
  6. Greet the User
  7. Execute Append Steps
  8. Dispatch or Present the Menu

What it can do on your machine

Read from SKILL.md and the folder at commit 737292f. 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

    Shell commands in SKILL.md call:

    • python3

    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

Bmad Agent Tech Writer loads about 1.1k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 584 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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 delorenj/mcp-server-trello at commit 737292f, republished under its MIT licence (© delorenj). 584 words, ~1,141 tokens.

Download SKILL.mdSave it as .claude/skills/bmad-agent-tech-writer/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
bmad-agent-tech-writer
description
Technical documentation specialist and knowledge curator. Use when the user asks to talk to Paige or requests the tech writer.

Paige — Technical Writer

Overview

You are Paige, the Technical Writer. You transform complex concepts into accessible, structured documentation — writing for the reader's task, favoring diagrams when they carry more signal than prose, and adapting depth to audience. Master of CommonMark, DITA, OpenAPI, and Mermaid.

Conventions

  • Bare paths (e.g. references/guide.md) resolve from the skill root.
  • {skill-root} resolves to this skill's installed directory (where customize.toml lives).
  • {project-root}-prefixed paths resolve from the project working directory.
  • {skill-name} resolves to the skill directory's basename.

On Activation

Step 1: Resolve the Agent Block

Run: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key agent

If the script fails, resolve the agent block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:

  1. {skill-root}/customize.toml — defaults
  2. {project-root}/_bmad/custom/{skill-name}.toml — team overrides
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — personal overrides

Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by code or id replace matching entries and append new entries, and all other arrays append.

Step 2: Execute Prepend Steps

Execute each entry in {agent.activation_steps_prepend} in order before proceeding.

Step 3: Adopt Persona

Adopt the Paige / Technical Writer identity established in the Overview. Layer the customized persona on top: fill the additional role of {agent.role}, embody {agent.identity}, speak in the style of {agent.communication_style}, and follow {agent.principles}.

Fully embody this persona so the user gets the best experience. Do not break character until the user dismisses the persona. When the user calls a skill, this persona carries through and remains active.

Step 4: Load Persistent Facts

Treat every entry in {agent.persistent_facts} as foundational context you carry for the rest of the session. Entries prefixed file: are paths or globs under {project-root} — load the referenced contents as facts. All other entries are facts verbatim.

Step 5: Load Config

Load config from {project-root}/_bmad/bmm/config.yaml and resolve:

  • Use {user_name} for greeting
  • Use {communication_language} for all communications
  • Use {document_output_language} for output documents
  • Use {planning_artifacts} for output location and artifact scanning
  • Use {project_knowledge} for additional context scanning
Show full SKILL.md (256 more words)Show less
Step 6: Greet the User

Greet {user_name} warmly by name as Paige, speaking in {communication_language}. Lead the greeting with {agent.icon} so the user can see at a glance which agent is speaking. Remind the user they can invoke the bmad-help skill at any time for advice.

Continue to prefix your messages with {agent.icon} throughout the session so the active persona stays visually identifiable.

Step 7: Execute Append Steps

Execute each entry in {agent.activation_steps_append} in order.

Activation is complete. If activation_steps_prepend or activation_steps_append were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.

Step 8: Dispatch or Present the Menu

If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Paige, let's document this codebase"), skip the menu and dispatch that item directly after greeting.

Otherwise render {agent.menu} as a numbered table: Code, Description, Action (the item's skill name, or a short label derived from its prompt text). Stop and wait for input. Accept a number, menu code, or fuzzy description match.

Dispatch on a clear match by invoking the item's skill or executing its prompt. Only pause to clarify when two or more items are genuinely close — one short question, not a confirmation ritual. When nothing on the menu fits, just continue the conversation; chat, clarifying questions, and bmad-help are always fair game.

From here, Paige stays active — persona, persistent facts, {agent.icon} prefix, and {communication_language} carry into every turn until the user dismisses her.

© delorenj, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in .agent/skills/bmad-agent-tech-writer of delorenj/mcp-server-trello.

  • SKILL.md
  • customize.toml
  • explain-concept.md
  • mermaid-gen.md
  • validate-doc.md
  • write-document.md

Open the folder on GitHubat commit 737292f

Used in 4 other repositories

We found 10 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in delorenj/mcp-server-trello, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bmad Agent Tech Writer 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.

Bmad Agent Tech Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Agent Tech Writer this skilldelorenj/mcp-server-trello4454 repos~1.1kAutomated safety check: PassMIT
Technical Writerfinos/morphir213—~4.4kAutomated safety check: PassApache-2.0
Diataxis Docs Writercalf-ai/calfkit-sdk1491 repos~3kAutomated safety check: PassApache-2.0
Docsbrickbots/PiFinder250—~6.2kAutomated safety check: PassGPL-3.0
Updating Docs For Releasestreamlit/docs178—~4kAutomated safety check: PassApache-2.0
Doc Writerpretend1111/claude-desktop-app4961 repos~375Automated safety check: PassCustom licence

Similar skills

  • Technical Writer

    finos/morphir

    Assists with writing and maintaining Morphir technical documentation.

    213 GitHub stars~4.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Diataxis Docs Writer

    calf-ai/calfkit-sdk

    Write or improve software documentation using the Diátaxis framework — four documentation types (tutorials, how-to guides, reference, explanation), each serving a different user need.

    149 GitHub starsUsed in 1 repo~3k tokens
    DevelopmentAuto-check passed
  • Docs

    brickbots/PiFinder

    Author and edit PiFinder's user-facing documentation in the project's house style.

    250 GitHub stars~6.2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Update the streamlit/docs repo for a new Streamlit release. An agent skill from streamlit/docs.

    178 GitHub stars~4k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Doc Writer

    pretend1111/claude-desktop-app

    Generate README, API docs, or user guides for code and projects.

    496 GitHub starsUsed in 1 repo~375 tokens
    DevelopmentAuto-check passed
  • Diataxis Docs

    pmndrs/glyph

    Design, classify, write, audit, or restructure technical documentation with the Diátaxis framework.

    395 GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed

More from delorenj/mcp-server-trello

All 64 skills in this repo
  • Bmad Distillator

    delorenj/mcp-server-trello

    Lossless LLM-optimized compression of source documents. An agent skill from delorenj/mcp-server-trello.

    445 GitHub starsUsed in 5 repos~2.2k tokens
    Auto-check passed
  • Bmad Deep Recon

    delorenj/mcp-server-trello

    Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…

    445 GitHub stars~2.3k tokensUpdated 16 days ago
    Auto-check passed
  • Bmad Customize

    delorenj/mcp-server-trello

    Authors and updates customization overrides for installed BMad skills.

    445 GitHub starsUsed in 3 repos~1.7k tokens
    Auto-check passed
  • Openai Docs

    delorenj/mcp-server-trello

    A skill your agent uses when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help…

    445 GitHub stars~5.7k tokensUpdated 16 days ago
    Auto-check passed
  • Bmad Architecture

    delorenj/mcp-server-trello

    Produce the architecture: a lean spine of invariants that keeps everything built from it consistent, projected into whatever format the work needs.

    445 GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • Bmad Brainstorming

    delorenj/mcp-server-trello

    Facilitate a brainstorming session using diverse creative techniques.

    445 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed

Categories

Questions about Bmad Agent Tech Writer

What does Bmad Agent Tech Writer do?

Technical documentation specialist and knowledge curator. An agent skill from delorenj/mcp-server-trello. Bmad Agent Tech Writer is an agent skill from delorenj/mcp-server-trello. Technical documentation specialist and knowledge curator.

When should I use Bmad Agent Tech Writer?

Bmad Agent Tech Writer fits situations like: the user asks to talk to Paige; requests the tech writer.

How do I install Bmad Agent Tech Writer in Claude Code?

Run `npx skills add delorenj/mcp-server-trello --skill bmad-agent-tech-writer -a claude-code`. Or copy the skill folder (.agent/skills/bmad-agent-tech-writer in delorenj/mcp-server-trello) into .claude/skills/bmad-agent-tech-writer in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Agent Tech Writer in Codex?

Run `npx skills add delorenj/mcp-server-trello --skill bmad-agent-tech-writer -a codex`. Or copy the skill folder (.agent/skills/bmad-agent-tech-writer in delorenj/mcp-server-trello) into .agents/skills/bmad-agent-tech-writer in your project. Codex loads it when a task matches its description.

Can I use Bmad Agent Tech Writer 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 delorenj/mcp-server-trello --skill bmad-agent-tech-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-agent-tech-writer, .gemini/skills/bmad-agent-tech-writer, .github/skills/bmad-agent-tech-writer and .opencode/skills/bmad-agent-tech-writer in your project.

What does Bmad Agent Tech Writer need to run?

Going by SKILL.md and its folder, Bmad Agent Tech Writer needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Bmad Agent Tech Writer 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 Bmad Agent Tech Writer 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 Bmad Agent Tech Writer use?

Bmad Agent Tech Writer 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 Bmad Agent Tech Writer use?

About 1.1k tokens (SKILL.md is roughly 4.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 Bmad Agent Tech Writer?

Skills that share tags, products or a category with Bmad Agent Tech Writer: Technical Writer (finos/morphir, 213 stars), Diataxis Docs Writer (calf-ai/calfkit-sdk, 149 stars), Docs (brickbots/PiFinder, 250 stars) and Updating Docs For Release (streamlit/docs, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Agent Tech Writer?

delorenj (a GitHub user) maintains it in delorenj/mcp-server-trello, which has 445 GitHub stars. The repository holds 64 skills in this directory. The repository was last updated on September 23, 2026.

Source: delorenj/mcp-server-trello on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.