---
title: "Write Docs - Air Market"
description: "You need to write something down - a proposal, a spec, a decision record, part of a README - and the hard part is that the reader will not have been in the room. This works through it with you in sta…"
canonical: "https://airmarket.ai/app/write-docs"
---

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

Skill by [GSD](/@gsd-build)

# Write Docs

Write it so a stranger can follow it, not just you

## What this does

You need to write something down - a proposal, a spec, a decision record, part of a README - and the hard part is that the reader will not have been in the room. This works through it with you in stages: collect the context, shape the structure together, then read it back as a stranger would. Reach for it when the document has to stand on its own.

### Top 3 things it does for you

- Draft a proposal or a spec
- Write a README section from scratch
- Rework a doc so a newcomer can follow it

## Information

**Write Docs at a glance**

|  |  |
| --- | --- |
| Kind | Skill |
| Publisher | [GSD](/@gsd-build) |
| Category | [Writing](/category/writing) |
| Works with | Agent Skills - an open standard supported by 40+ agents |
| Size | 5 KB |
| Licence | MIT |
| Repository | [gsd-build/gsd-2](https://github.com/gsd-build/gsd-2/tree/4ea7d80e76af01a6c566a44989b451bae51ec6f3/src/resources/skills/write-docs) |
| GitHub stars | 7,762 (as of Nov 2026) |
| Installs | 6, counted by skills.sh (Nov 2026) |

## Security report

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

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

|  |  |
| --- | --- |
| Commit | 4ea7d80e76af01a6c566a44989b451bae51ec6f3 |
| Content hash | 9335526b7306dad587f078b29bfc508c539cb62823f3e07f80b8c5931f15157c |
| Files read | [Browse the files at this exact commit](https://github.com/gsd-build/gsd-2/blob/4ea7d80e76af01a6c566a44989b451bae51ec6f3/src/resources/skills/write-docs/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 Docs](/security/write-docs)

## About Write Docs

A collaborative authoring workflow for documents that must work for fresh readers: proposals, technical specs, decision docs, README sections, ADRs, and long-form prose.

It runs in three stages - gather context, iterate on structure, then reader-test the result for a stranger - so the shape is agreed before the writing is refined, and the finished document is checked against someone who does not have this session's context.

Reach for it when you ask to write the docs, draft a proposal, write a spec or an RFC, write the README, or whenever a document has to be understandable without the conversation behind it.

## What's inside

- SKILL.md - instructions

## Questions

### Is Write Docs safe to install?

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

### How do I install Write Docs?

Open https://airmarket.ai/app/write-docs 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/gsd-build/gsd-2/tree/4ea7d80e76af01a6c566a44989b451bae51ec6f3/src/resources/skills/write-docs. Install from that link, not the branch.

## Related on Air Market

- [More Writing listings](/category/writing)
- [Everything by GSD](/@gsd-build)

---

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