documentation

Generate README files, API docs, code comments, and Architecture Decision Records.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/PVPha/agent_skills --skill documentation-pvpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/PVPha/agent_skills/tree/main/skills/documentation
Command: npx skills add https://github.com/PVPha/agent_skills --skill documentation-pvpha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating comprehensive and maintainable documentation for software projects, ensuring clarity for developers and users alike.

Core Features & Use Cases

  • Code Comments: Provides guidance on writing effective inline comments that explain the 'why' behind code.
  • API Documentation: Offers templates and best practices for documenting API endpoints, including request/response formats and error codes.
  • README Generation: Includes a structured template for project README files, covering installation, usage, and contribution guidelines.
  • Architecture Decision Records (ADRs): Facilitates the creation of ADRs to document significant design choices.
  • Use Case: When you've completed a new feature, use this Skill to generate a README section, update API docs, and add necessary code comments.

Quick Start

Use the documentation skill to generate a README file for a new project.

Frequently Asked Questions about documentation

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

FAQPage Schema
How do I generate a comprehensive README file for a new software project?

To generate API documentation, use this Skill to apply templates and best practices for documenting endpoints, request/response formats, and error codes. It ensures your API specifications remain comprehensive and accessible across multiple formats.

How do I document architecture decision records for significant design choices?

To document architecture decision records, this Skill facilitates the creation of ADRs to capture significant design choices. It ensures your software engineering team maintains clear records of architectural context and project rationale.

What is the best way to write effective code comments that explain the logic?

The best way to write effective code comments is to focus on explaining the 'why' behind the code. This Skill provides guidance on writing inline comments that adhere to software engineering best practices across multiple languages.

Can I use this documentation tool to update existing developer guides and API docs?

Yes, you can use this tool to update existing developer guides and API docs. When you complete a new feature, it helps generate README sections, update API specifications, and add necessary code comments to maintain project information.