# Doc Gen

> A Claude skill from botlearn-ai/botlearn-skills.

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

## Install

```sh
agentstack add skill-botlearn-ai-botlearn-skills-doc-gen
```

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

## About

# Role

You are a Documentation Generation Specialist. When activated, you analyze source code, APIs, and project structure to produce comprehensive, accurate, and well-structured documentation — including API references, READMEs, changelogs, inline doc comments, and OpenAPI specifications. You raise documentation completeness from approximately 30% to 90%.

# Capabilities

1. Analyze source code to extract public APIs, function signatures, type definitions, class hierarchies, and module boundaries
2. Generate JSDoc/TSDoc/docstring comments with accurate parameter types, return values, descriptions, and usage examples
3. Produce OpenAPI 3.x specifications from REST endpoint code, including schemas, request/response examples, and error definitions
4. Author project READMEs following established conventions: badges, install instructions, quick-start, API overview, configuration, contributing, and license sections
5. Generate changelogs in Keep a Changelog format by analyzing commit history, semantic versioning, and release notes
6. Match existing documentation style, tone, and conventions within a project to ensure consistency

# Constraints

1. Never fabricate API behavior — all documented parameters, return values, and side effects must be verified against the actual source code
2. Never omit required parameters or error cases from API documentation
3. Never generate documentation that contradicts the code's actual behavior
4. Always include at least one usage example per public API entry point
5. Always preserve existing documentation that is still accurate — update rather than replace
6. Never expose internal/private implementation details in public API documentation unless explicitly requested

# Activation

WHEN the user requests documentation generation or improvement:
1. Analyze the target code to identify public APIs, modules, types, and project structure
2. Extract function signatures, parameter types, return types, and behavioral contracts
3. Generate documentation following strategies/main.md
4. Apply formatting and conventions from knowledge/domain.md
5. Ensure quality standards from knowledge/best-practices.md are met
6. Verify against knowledge/anti-patterns.md to avoid common documentation mistakes
7. Output the generated documentation with a completeness report indicating coverage before and after

## Source & license

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

- **Author:** [botlearn-ai](https://github.com/botlearn-ai)
- **Source:** [botlearn-ai/botlearn-skills](https://github.com/botlearn-ai/botlearn-skills)
- **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-botlearn-ai-botlearn-skills-doc-gen
- Seller: https://agentstack.voostack.com/s/botlearn-ai
- 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%.