# Docs Structure

> Structure technical documentation for APIs, guides, and README. Use when writing docs, README, API references, or working with technical-writer. Use when this capability is needed.

- Skill: `tomevault-io/docs-structure` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/docs-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/docs-structure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/docs-structure

---


# Docs Structure

## README Template
```
# Project Name
Brief description (1-2 sentences)

## Quick Start
- Prerequisites
- Install steps
- Run command

## Key Features
- Bullet list

## Configuration
- Env vars, config options

## Usage
- Examples

## Contributing / License
```

## API Reference
- Endpoint: method, path, description
- Parameters: name, type, required, description
- Response: status, body shape, example
- Errors: possible codes and meanings

## User Guide
- Task-oriented headings
- Step-by-step with numbered lists
- Code examples where relevant
- Screenshots for UI flows

## Principles
- **Audience first**: Match skill level and goals
- **Scannable**: Headings, bullets, short paragraphs
- **Examples**: Working code over abstract description
- **Up to date**: Remove outdated docs when changing behavior

---
> Source: [iamjcabalejo/payoys-cursor-sub-agents](https://github.com/iamjcabalejo/payoys-cursor-sub-agents) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-04 -->