writing-documentation

Generate READMEs, API references, user guides, ADRs, and runbooks from codebases.

Updated Nov 25, 2025
One-click install
npx skills add https://github.com/hernamesbarbara/promptkit --skill writing-documentation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-documentation
Source: https://github.com/hernamesbarbara/promptkit/tree/main/.claude/skills/writing-documentation
Command: npx skills add https://github.com/hernamesbarbara/promptkit --skill writing-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a framework and workflow for creating clear, comprehensive technical documentation, including READMEs, API references, user guides, architecture docs, ADRs, and runbooks. It also defines when to delegate to the writing-documentation agent for large outputs.

Core Features & Use Cases

  • Documentation from code: Generate API references, endpoint descriptions, and schemas.
  • Guides & Architecture: Produce user guides, architecture docs, and ADRs.
  • Validation & Quality: Includes validation workflows and templates to ensure consistency.
  • Handoff & Delegation: Seamlessly delegate to the writing-documentation agent for multi-file outputs.

Quick Start

Tell the agent to generate API documentation for the authentication module or write a complete user guide.

Frequently Asked Questions about writing-documentation

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

FAQPage Schema
How do I generate API documentation from my codebase?

API documentation can be generated by extracting endpoint descriptions, parameter schemas, and response structures from your code. This Skill produces formatted API references that include endpoint details, authentication requirements, and usage examples, ready for delivery to users.

What's the best way to create architecture documentation and ADRs?

Architecture documentation and Architecture Decision Records (ADRs) capture design rationale and system structure. This Skill generates both from your architectural designs, enforcing consistent formatting, cross-references, and traceability so decisions remain discoverable and justified.

Can I generate user guides and runbooks automatically?

User guides and runbooks can be generated from your codebase and operational procedures. This Skill produces audience-focused documentation including step-by-step instructions, troubleshooting sections, and procedural runbooks formatted for clarity and searchability.

How do I ensure documentation consistency across multiple files?

Consistency is enforced through validation workflows and structured templates. This Skill applies formatting rules, cross-reference validation, and consistency checks across READMEs, API references, user guides, and architecture docs to maintain uniform structure and language.

Do I need to manually update existing documentation when code changes?

Documentation updates can be automated alongside code changes. This Skill handles both new documentation generation and updates to existing material, reducing manual maintenance and keeping documentation synchronized with current implementations.

What types of documentation does this cover?

Coverage includes READMEs, API references, user guides, architecture documentation, ADRs, and runbooks. The Skill generates vector-embedding-ready documentation artifacts with proper structure, formatting, and cross-references for comprehensive technical documentation needs.