doc-writer

Generate README, Markdown, HTML, and PDF documentation from source code.

1|1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/scottconverse/productteam --skill doc-writer-scottconverse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-writer
Source: https://github.com/scottconverse/productteam/tree/main/skills/doc-writer
Command: npx skills add https://github.com/scottconverse/productteam --skill doc-writer-scottconverse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Developers and documenters spend valuable time creating detailed documentation; this Skill automates that process, ensuring accuracy and consistency without manual effort.

Core Features & Use Cases

  • Source Code Analysis: Reads all source files, tests, and configuration to build an inventory of software components.
  • Automated Documentation Generation: Produces README.md, extended docs, and other materials aligned with the codebase.
  • Architecture Visualization: Creates SVG diagrams illustrating system components and data flow, embedded in docs.
  • Cover Multiple Documentation Formats: Generates Markdown, plain text, HTML landing pages, and PDFs from source code.
  • Use Case: Quickly document an entire API and system architecture after a code update without manual writing.

Quick Start

Run the doc-writer tool to analyze the source code and generate all documentation files, including architecture diagrams and terms of service, with a single command.

Frequently Asked Questions about doc-writer

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

FAQPage Schema
How do I automatically generate documentation from source code?

To automatically generate documentation from source code, you need a tool that reads your source files, tests, and configuration to build a component inventory. This process extracts system architecture and design decisions to produce accurate README.md files, extended docs, and API references without manual writing.

Can I generate PDF and HTML documentation directly from my codebase?

Yes, you can generate PDF and HTML documentation directly from your codebase. Automated documentation generation tools analyze source code to output multiple formats, including Markdown, plain text, HTML landing pages, and PDFs, ensuring your documentation matches your actual code structure and dependencies.

How do I create architecture diagrams for my API documentation?

Creating architecture diagrams for API documentation involves visualizing system components and data flow. Automated tools can read your source code and configuration to generate SVG diagrams illustrating system architecture, which are then embedded directly into your generated documentation files.

What is the best way to document system architecture after a code update?

The best way to document system architecture after a code update is using automated source code analysis. This ensures your generated content matches the actual updated code structure, dependencies, and design decisions, streamlining both onboarding and maintenance without requiring manual rewriting.

Do I need to manually write configuration files to automate project documentation?

No, you do not need to manually write configuration files to automate project documentation. The automation process directly extracts and synthesizes system documentation by reading your existing source code, configuration, and tests to build a comprehensive and accurate project overview.

Does automated code documentation work for API and user documentation simultaneously?

Automated code documentation works for API, architecture, and user documentation simultaneously. By analyzing source files, tests, and configuration, the extraction process builds a unified inventory of software components applicable to all documentation formats, streamlining onboarding and maintenance.