# Create Documentation

> Create documentation for a feature or component following the Divio documentation framework (tutorials, how-to guides, reference, explanation).

- **Type:** Skill
- **Install:** `agentstack add skill-tomzx-agents-create-documentation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tomzx](https://agentstack.voostack.com/s/tomzx)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tomzx](https://github.com/tomzx)
- **Source:** https://github.com/tomzx/agents/tree/main/skills/create-documentation

## Install

```sh
agentstack add skill-tomzx-agents-create-documentation
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Create Documentation

Produces documentation for a feature or component organized according to the [Divio documentation framework](https://docs.divio.com/documentation-system/): tutorials, how-to guides, reference, and explanations.

**For detailed Divio guidance** (DO/DON'T lists, decision trees, per-type structures), consult the `divio-documentation` skill. This skill focuses on the production workflow: deciding which types to write and producing the output.

## Prerequisites

- Apply the shared SDLC conventions in `skills/sdlc/references/shared.md`.
- If no argument is provided, locate the feature directory under `.sdlc/features/` whose frontmatter `issue` field references `$ISSUE_NUMBER`.
- Feature or component description provided in context or as `$1`
- Access to the codebase, specification, or implementation (if available)

## Steps

1. Understand the feature: what it does, who uses it, and common use cases.
2. Identify which documentation types are needed (use the decision tree in `divio-documentation` if unsure).
3. Follow the DO/DON'T rules and structure templates from `divio-documentation` for each type.
4. Write a tutorial if users need onboarding guidance.
5. Write how-to guides for the most common user tasks.
6. Write reference documentation for all public APIs, config options, and interfaces.
7. Write an explanation section if the design or behavior needs conceptual context.
8. Cross-link between types but keep their boundaries clean.
9. Write the documentation to `.sdlc/features/N-/documentation.md`, creating the directory if it does not exist.

## Output Format

Use the template at `skills/sdlc/templates/features/documentation.md` (copied to `.sdlc/templates/features/documentation.md` by `/initialize-sdlc-directory`; use the project's customized copy if present). Write the result to the artifact path named in the steps above.

## Outcome

If `$OUTCOME_YAML` is set, emit `verdict: approved` there per `skills/sdlc/references/shared.md`, mirroring the `status: draft` written to the artifact. If the artifact could not be produced, omit the file.

## Example Usage

**Scenario 1: New CLI command**
Document `create-requirements`: tutorial (run your first requirements doc), how-to (generate requirements from a GitHub issue), reference (all input formats accepted), explanation (why MoSCoW prioritization is used).

**Scenario 2: Internal library**
Document a cache abstraction: how-to guides for common cache patterns, full reference for every method, explanation of the eviction strategy chosen.

## Completion Checklist

Before handing off to review, confirm:

- [ ] Only the Divio types this feature actually needs are written, not all four by default
- [ ] Code examples run against the current codebase

Self-check the draft against the [`review-documentation` checklist](../review-documentation/SKILL.md) and fix what you can, so review finds less to flag.

## Useful Commands Reference

No CLI commands required. This skill operates on information provided in context.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tomzx](https://github.com/tomzx)
- **Source:** [tomzx/agents](https://github.com/tomzx/agents)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tomzx-agents-create-documentation
- Seller: https://agentstack.voostack.com/s/tomzx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.