# write-docs

write-docs — a skill for writing BrowserOS feature documentation automatically. Explores the codebase, gathers screenshots, and generates Mintlify MDX pages.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 14442 repo stars
- Author: browseros-ai
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/browseros-ai/BrowserOS/tree/HEAD/.claude/skills/write-docs/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/browseros-ai-write-docs

## What it does

write-docs streamlines documentation for BrowserOS features by following a structured workflow. The skill searches the codebase to understand how a feature works, prompts you to capture screenshots, then generates a concise MDX file with setup instructions and practical examples. All docs stay to one page—no unnecessary sections.

The skill has built-in access to file tools (Read, Grep, Glob, Bash, Task, Write, Edit), so it navigates the repository independently, locates relevant code, and saves images. Once the doc is written, it guides you to add the page to `docs/docs.json` and preview everything locally via `mint dev`.

Installation varies by IDE: Claude Code uses `npx skills add browseros-ai/BrowserOS --skill write-docs -a claude-code`, GitHub Copilot uses `gh skill install`, and other platforms use similar commands with their platform name. After setup, the skill pulls `SKILL.md` into your editor's config folder.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add browseros-ai/BrowserOS --skill write-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/write-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/write-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add browseros-ai/BrowserOS --skill write-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/write-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add browseros-ai/BrowserOS --skill write-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/write-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install browseros-ai/BrowserOS .claude/skills/write-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/write-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add browseros-ai/BrowserOS --skill write-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/browseros-ai/BrowserOS --path .claude/skills/write-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/write-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add browseros-ai/BrowserOS --skill write-docs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/browseros-ai/BrowserOS/tree/HEAD/.claude/skills/write-docs/SKILL.md

## When to use it
- write documentation for a new BrowserOS feature
- generate Mintlify MDX pages with proper structure
- add screenshots and embed them into docs
- update `docs/docs.json` navigation when publishing a new page

## Example prompts
- Write docs for the MCP Server feature
- Create an MDX page explaining scheduled tasks with code examples
- Explore the codebase and document how to connect external MCPs to the BrowserOS assistant

## Similar
- [docs-write](https://affpapa.org/en/nevibecode/skills/docs-write.md) — skill · 2100 installs
- [mintlify](https://affpapa.org/en/nevibecode/plugins/mintlify.md) — plugin · ★ 7 repo stars
- [rspress-docs-generator](https://affpapa.org/en/nevibecode/skills/rspress-docs-generator.md) — skill · 344 installs
- [docs-components](https://affpapa.org/en/nevibecode/skills/docs-components.md) — skill · 1 install
- [docs-sandpack](https://affpapa.org/en/nevibecode/skills/docs-sandpack.md) — skill · ★ 11851 repo stars
- [prowler-docs](https://affpapa.org/en/nevibecode/skills/prowler-docs.md) — skill · ★ 15302 repo stars

## Other versions with the same name
- [write-docs · tldraw](https://affpapa.org/en/nevibecode/skills/tldraw-write-docs.md) — 491 installs
- [write-docs · gitbookio](https://affpapa.org/en/nevibecode/skills/write-docs.md) — 828 installs

From the same set: [browseros-ai/browseros](https://affpapa.org/en/nevibecode/by/browseros-ai/browseros.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
