---
title: "Write BRD - Air Market"
description: "You have an idea, a customer ask, or a problem you want to fix, and someone wants it written up properly before anyone builds it. This writes the business requirements document for you, in Markdown,…"
canonical: "https://airmarket.ai/app/write-brd"
---

[Air Market](/) / [Writing](/category/writing) / Write BRD

Skill by [Digoal.zhou](/@digoal)

# Write BRD

Turn a rough product idea into a document people can review

## What this does

You have an idea, a customer ask, or a problem you want to fix, and someone wants it written up properly before anyone builds it. This writes the business requirements document for you, in Markdown, saved with your project's other docs. It can draw the diagrams too. Reach for it when the idea is clear in your head but not yet on paper.

### Top 3 things it does for you

- Draft a BRD from a half-formed idea
- Turn a customer request into requirements
- Add diagrams to a business case

## Information

**Write BRD at a glance**

|  |  |
| --- | --- |
| Kind | Skill |
| Publisher | [Digoal.zhou](/@digoal) |
| Category | [Writing](/category/writing) |
| Works with | Agent Skills - an open standard supported by 40+ agents |
| Size | 15 KB |
| Licence | GPL-2.0 |
| Repository | [digoal/blog](https://github.com/digoal/blog/tree/cb3a91c976c0c5b392f640743cd8f776223e21d7/skills/write-brd) |
| GitHub stars | 8,560 (as of Nov 2026) |

## Security report

**Verified.** AIR scanned this exact version of Write BRD and flagged nothing. AIR's verdict: **safe**.

**What Write BRD's check was run against**

|  |  |
| --- | --- |
| Commit | cb3a91c976c0c5b392f640743cd8f776223e21d7 |
| Content hash | 25d75b07450f1488fcfee73eca29854e09fa48caecc288b597cb0c01e4161dfa |
| Files read | [Browse the files at this exact commit](https://github.com/digoal/blog/blob/cb3a91c976c0c5b392f640743cd8f776223e21d7/skills/write-brd/SKILL.md) |

A scan is named by the exact content it read, not by a version number. A different version is a different artifact, and nothing here applies to a version AIR has not scanned.

[Read the full security report for Write BRD](/security/write-brd)

## About Write BRD

Give it a product idea, a feature concept, a customer request, a business problem, or an opportunity you have not thought all the way through, and it writes a practical business requirements document from it.

The output is Markdown and can be saved under the current project's markdown directory, so the business case sits with the rest of the work. Diagrams can be included as Mermaid, SVG, or ASCII where a picture explains more than a paragraph.

It also handles work on a BRD that already exists: drafting, generating, refining, or saving a business requirements document or product business case.

## What's inside

- SKILL.md - instructions
- agents/openai.yaml - data
- assets/brd-template.md - reference
- references/brd-writing-guide.md - reference

## Questions

### Is Write BRD safe to install?

AIR scanned this exact version of Write BRD and flagged nothing. AIR's verdict: safe. The verdict is named by the content that was read, at commit cb3a91c976c0, so it cannot drift onto a version nobody scanned. The full report is at https://airmarket.ai/security/write-brd.

### How do I install Write BRD?

Open https://airmarket.ai/app/write-brd on Air Market and use the install action: Air Market hands Claude a prompt naming this exact skill, and Claude sets it up. Source, pinned to the exact commit this listing describes: https://github.com/digoal/blog/tree/cb3a91c976c0c5b392f640743cd8f776223e21d7/skills/write-brd. Install from that link, not the branch.

## Related on Air Market

- [More Writing listings](/category/writing)
- [Everything by Digoal.zhou](/@digoal)

---

Canonical URL: <https://airmarket.ai/app/write-brd>