documentation

Generate and maintain technical documentation for APIs, code, architecture, and user guides.

1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/josavicentevw/ai-agent-skills --skill documentation-josavicentevw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/josavicentevw/ai-agent-skills/tree/main/skills/documentation
Command: npx skills add https://github.com/josavicentevw/ai-agent-skills --skill documentation-josavicentevw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generating and maintaining accurate, up-to-date technical documentation across APIs, code, architecture, and user guides is time-consuming and error-prone. This Skill automates the creation and upkeep of docs to improve developer onboarding and API usability.

Core Features & Use Cases

  • API Documentation: generate REST/GraphQL/OpenAPI docs with examples and error schemas.
  • README & Onboarding: draft READMEs, contribution guides, getting-started sections.
  • Architecture & ADRs: document architecture decisions, diagrams, and ADRs.
  • Code Documentation: generate comments, docstrings, and in-line docs.
  • User Guides: create tutorials, how-tos, and troubleshooting guides.
  • Template-based: uses templates to ensure consistent style.

Quick Start

Provide a concise prompt, for example: "Create API docs for the Payments service, including endpoints, payload examples, authentication details, and error codes." Then adjust as needed for your project.

Frequently Asked Questions about documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation for a REST service with payload examples and error codes?

To generate API documentation, provide a concise prompt describing your REST service endpoints, authentication details, and payload examples. The skill outputs structured docs including error schemas and examples, mirroring professional technical writing practices.

What is the best way to write architecture decision records and maintain technical documentation?

Writing architecture decision records is best handled by providing your architectural context to the skill, which then drafts structured ADRs, diagrams, and architecture documentation using consistent templates to ensure maintainable technical docs.

Can I use templates to ensure consistent style across READMEs and user guides?

Yes, you can use templates to ensure consistent style. The skill is template-based, automatically applying uniform formatting and structure across READMEs, contribution guides, getting-started sections, and troubleshooting tutorials.

How do I create a README and getting-started guide for developer onboarding?

To create a README for developer onboarding, prompt the skill with your project details. It drafts comprehensive READMEs, contribution guides, and getting-started sections that improve API usability and accelerate developer onboarding.

Does this tool support generating in-line code docstrings and comments?

Yes, the tool supports generating in-line code documentation. It creates comments, docstrings, and in-line docs directly from your code, automating the upkeep of accurate technical documentation across your codebase.

How do I document OpenAPI and GraphQL schemas with examples?

To document OpenAPI and GraphQL schemas, provide your schema definitions to the skill. It generates comprehensive API documentation complete with payload examples, authentication details, and error schemas for improved API usability.