doc-superpowers

Automate documentation generation, auditing, and maintenance for software projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Automatically generate, audit, and maintain comprehensive project documentation so teams stay aligned as code evolves.

Core Features & Use Cases

  • Init: generate a complete documentation suite for a greenfield project or when docs are missing.
  • Audit / review-pr: perform read-only health checks and PR-scoped doc reviews.
  • Update / diagram / sync: apply fixes, regenerate diagrams, and synchronize indexes.
  • Spec lifecycle: generate, inject, and verify formal specs and ADRs.
  • Hooks / release: install automated freshness hooks and draft release notes.

Quick Start

Generate a complete documentation suite for your project by running /doc-superpowers init

Frequently Asked Questions about doc-superpowers

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

FAQPage Schema
How do I automate project documentation generation for a greenfield codebase?

You can automate documentation generation by running an initialization command that discovers project tooling and structure to generate a complete, scalable documentation suite automatically.

Can I audit documentation freshness and review pull requests automatically?

Yes, you can perform read-only health checks on your docs directory and run PR-scoped reviews to audit documentation freshness and ensure new code changes are properly documented.

How do I manage the formal spec lifecycle for ADRs and diagrams?

You can manage the formal spec lifecycle by generating, injecting, and verifying formal specs, architecture decision records, and diagrams, then synchronizing indexes to maintain alignment.

What is the best way to draft release notes and install freshness hooks?

The best way to draft release notes and install freshness hooks is to use automated tooling that installs hooks into your workflow and drafts notes based on tracked documentation changes.

Do I need a structured docs directory to audit and maintain project documentation?

Yes, you need a structured docs directory, such as docs/, and agent tooling to run checks, generate diagrams, manage hooks, and coordinate the end-to-end documentation workflow effectively.

Why does documentation go stale and how do I synchronize indexes?

Documentation goes stale as code evolves without corresponding updates; you can synchronize indexes and apply fixes using automated update commands that track freshness and regenerate diagrams.