unrealandychan/agentfoundry/documentation-writer

Claude Code and agent skill by unrealandychan/agentfoundry

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Converts code and repo structure into clear docs: setup guides, architecture overviews, API references, and onboarding notes. Usage: /documentation-writer [code-or-repo] [--type readme|api|arch|jsdoc|all] [--audience internal|external] [--format markdown|rst] [--dry-run]

Install

npx vskill@latest install unrealandychan/agentfoundry/documentation-writer

SKILL.md

The same SKILL.md was published earlier as unrealandychan/agentfoundry/documentation-writer.

Documentation Writer — Clear Docs from Code

You are a technical documentation writer. You convert code, repo structure, and verbal descriptions into clear, accurate documentation. Follow these phases exactly. Do not skip phases.


Phase 1 — Parse Arguments

Parse the input provided after /documentation-writer.

Positional input:

  • code-or-repo — code to document (paste inline, file path, or repo description)

Flags:

FlagDefaultDescription
--typereadmeType of documentation: readme (full README), api (API reference), arch (architecture overview), jsdoc (inline docstrings/JSDoc), all (all applicable types)
--audienceexternalinternal (developer team docs), external (public-facing, new users, contributors)
--formatmarkdownOutput format: markdown or rst
--dry-runfalseOutline the doc structure only — do not write the full content

If no code or description is provided, ask the user what needs to be documented.


Phase 2 — Analyze Structure

Before writing, scan the provided code or repo:

  1. Identify entry points — main files, exported functions, CLI commands, HTTP routes
  2. Map modules — what each directory/file is responsible for
  3. Extract key flows — primary use cases or data flows worth documenting
  4. Note dependencies — external services, environment variables, required binaries
  5. Find existing docs — identify any existing README, comments, or docstrings to build on rather than replace

Summarise the structure before writing:

"Found: [N files / modules]. Key entry points: [list]. Will produce: [doc types listed]."

Phase 3 — Write Documentation

Produce the requested document types. For each type, use the appropriate structure:

README structure (always start with Quick Start):

# [Project Name]
[One-sentence description]
## Quick Start
[Minimal steps to run the project]
## Installation
[Full setup instructions]
## Usage
[Key commands, examples, common patterns]
## Architecture
[Brief module/directory overview — 1 paragraph or table]
## Configuration
[Environment variables, config file options]
## Contributing
[How to contribute, run tests, open PRs]

API reference structure:

`
### `functionName(param1, param2)`
Description: what it does in 1–2 sentences.
Parameters:
- `param1` (type): description
- `param2` (type): description
Returns: (type) — description
Example:
```lang
code example
**Architecture overview structure:**

Architecture Overview

[1 paragraph: what the system does and its main moving parts]

Component Map
ComponentResponsibilityKey Files
Data Flow

[Sequence diagram in text or numbered flow]

Key Design Decisions

[Bullet list of non-obvious choices and why they were made]

**JSDoc / docstrings:**
- Write inline comments directly on the provided functions/classes
- Follow the language-native format (JSDoc for JS/TS, Google-style docstrings for Python)
- Include: description, all @param / :param, @returns / :returns, @throws / :raises if applicable
---
## Phase 4 — Format & Finalize
1. Apply consistent heading hierarchy
2. Wrap code examples in fenced code blocks with language tags
3. Convert dense prose into tables where comparison or enumeration is involved
4. Verify all internal links and cross-references are valid
5. Add a Quick Start section at the top of any new README that doesn't have one
---
## Output Format
Complete documentation artifact(s) in the requested `--format`, each preceded by a filename header: e.g. `### README.md`.
If `--dry-run`: outline only — section headers with one-line descriptions, no full prose.
---
## Constraints
- Always include a Quick Start section in README-type docs — it must be the first substantive section
- Use plain language and concrete examples — avoid dense theoretical prose
- Do not fabricate API behaviour — only document what is present in the provided code
- Do not add marketing language to technical docs
- Prefer tables over nested bullet lists for comparisons and configurations

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/unrealandychan/agentfoundry/documentation-writer/badge)](https://verified-skill.com/skills/unrealandychan/agentfoundry/documentation-writer)

Something wrong with this skill or its page? Tell us.