Pages: Documentation Site
Guides documentation site structure, navigation, and content organization. Typically hosted on docs.* or help.* subdomain. Includes Getting Started, guides, tutorials, API Reference (endpoint docs), and troubleshooting. Distinct from API introduction page (api-page-generator).
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product, audience, and use cases.
Identify:
- Product type: Software, API, hardware, service
- Audience: End users, developers, admins
- Content sources: Markdown, MDX, Git, CMS
- Subdomain: docs., help., or path (/docs)
Documentation Structure
| Section |
Purpose |
Typical Content |
| Getting Started |
Onboarding, first steps |
Quick start, installation, first task |
| Guides / Tutorials |
Step-by-step learning |
How-to articles, workflows |
| Concepts |
Background, architecture |
Key concepts, glossary links |
| API Reference |
Endpoint docs |
Auth, request/response, examples; part of docs, not separate page |
| Troubleshooting |
Problem solving |
FAQ, common errors, support links |
Best Practices
Information Architecture
- Progressive disclosure: Start simple, link to depth
- Sidebar navigation: Hierarchical, collapsible sections
- Search: Full-text search for long doc sets
- Breadcrumbs: For deep hierarchies
API Reference (within Docs)
API Reference is a section of docs, not a standalone page. Include: endpoints by resource, auth, request/response schemas, error codes, rate limits, code examples (cURL, SDKs). Use OpenAPI/Swagger for consistency.
Content
- Task-oriented: "How to X" not "X feature"
- Code examples: Copy-paste ready, multiple languages if relevant
- Screenshots/videos: For UI-heavy products
- Versioning: Document product/API version when applicable
SEO and Discovery
- Index docs: Unless internal-only; use robots if needed
- Internal links: Cross-link related articles, link to main site
- Schema: TechArticle, HowTo for guides
Output Format
- Structure (sections, hierarchy)
- Navigation design (sidebar, top-level)
- Getting Started outline
- Content checklist per section
- Subdomain/path recommendation
Related Skills
- api-page-generator: API intro page links to docs
- sidebar-generator: Docs sidebar design
- faq-page-generator: FAQ can live in docs or main site
- howto-section-generator: HowTo step blocks in guides/tutorials; TechArticle + HowTo alignment
- content-strategy: Doc content planning
1---
2name: docs-page-generator
3description: When the user wants to create, optimize, or structure a documentation site. Also use when the user mentions "docs," "documentation site," "docs subdomain," "docs.yourdomain.com," "help center," "knowledge base," "Getting Started," "API Reference," "user guides," or "tutorials." For API marketing landing, use api-page-generator.
4metadata:
5 version: 1.0.1
6---
7
8# Pages: Documentation Site
9
10Guides documentation site structure, navigation, and content organization. Typically hosted on `docs.*` or `help.*` subdomain. Includes Getting Started, guides, tutorials, **API Reference** (endpoint docs), and troubleshooting. Distinct from API introduction page (api-page-generator).
11
12**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
13
14## Initial Assessment
15
16**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for product, audience, and use cases.
17
18Identify:
191. **Product type**: Software, API, hardware, service
202. **Audience**: End users, developers, admins
213. **Content sources**: Markdown, MDX, Git, CMS
224. **Subdomain**: docs.*, help.*, or path (/docs)
23
24## Documentation Structure
25
26| Section | Purpose | Typical Content |
27|---------|---------|-----------------|
28| **Getting Started** | Onboarding, first steps | Quick start, installation, first task |
29| **Guides / Tutorials** | Step-by-step learning | How-to articles, workflows |
30| **Concepts** | Background, architecture | Key concepts, glossary links |
31| **API Reference** | Endpoint docs | Auth, request/response, examples; part of docs, not separate page |
32| **Troubleshooting** | Problem solving | FAQ, common errors, support links |
33
34## Best Practices
35
36### Information Architecture
37
38- **Progressive disclosure**: Start simple, link to depth
39- **Sidebar navigation**: Hierarchical, collapsible sections
40- **Search**: Full-text search for long doc sets
41- **Breadcrumbs**: For deep hierarchies
42
43### API Reference (within Docs)
44
45API Reference is a section of docs, not a standalone page. Include: endpoints by resource, auth, request/response schemas, error codes, rate limits, code examples (cURL, SDKs). Use OpenAPI/Swagger for consistency.
46
47### Content
48
49- **Task-oriented**: "How to X" not "X feature"
50- **Code examples**: Copy-paste ready, multiple languages if relevant
51- **Screenshots/videos**: For UI-heavy products
52- **Versioning**: Document product/API version when applicable
53
54### SEO and Discovery
55
56- **Index docs**: Unless internal-only; use robots if needed
57- **Internal links**: Cross-link related articles, link to main site
58- **Schema**: TechArticle, HowTo for guides
59
60## Output Format
61
62- **Structure** (sections, hierarchy)
63- **Navigation** design (sidebar, top-level)
64- **Getting Started** outline
65- **Content** checklist per section
66- **Subdomain/path** recommendation
67
68## Related Skills
69
70- **api-page-generator**: API intro page links to docs
71- **sidebar-generator**: Docs sidebar design
72- **faq-page-generator**: FAQ can live in docs or main site
73- **howto-section-generator**: HowTo step blocks in guides/tutorials; TechArticle + HowTo alignment
74- **content-strategy**: Doc content planning
kostja94