03 / Repository docs

← All task guides

Document an existing repository

Choose the documentation workflow that fits the artifact you need: README, architecture documentation, or a reusable documentation pipeline.

Last meaningful review July 13, 2026

The job

You have a codebase and need documentation that reflects the existing implementation rather than generic prose.

IncludedREADME · architecture documentation · maintainer documentation

Not this pagemarketing copy · API hosting platform setup

Fast route

01

You need a reusable docs workflow that reads the repository.

The skill is declared for document-oriented workflows and assets.

Consider docs
02

You are documenting project decisions and implementation plans.

It is structured around plans and implementation context.

Consider writing-plans

Source-led comparison

What changes the choice

Facts are extracted from the selected Skill’s declared workflow. Signals describe public adoption; they are not a universal score.

How to choose

Match the condition first.

Start with the fast route above. Then compare the candidate’s declared action, edit behaviour, context requirement and setup friction against the way you actually plan to work.

Why these candidates

Each candidate is selected from tracked public sources and has a visible, source-attributed adoption signal. We keep the shortlist small; this is not a catalogue or a global ranking.

Limits of this page

We read declared instructions and public signals. We do not run skills, benchmark outputs, audit security, or claim a universal best choice.

Candidate notes

Use it forDocument-centered workflows that need structured artifacts.

Avoid ifYou only need a two-line README adjustment.

ContextHigh

Outputunknown

Controlunknown

Agent fitunknown

Watch outDeclared behavior is source-linked, not independently tested.

EvidenceCatalog skill is declared for documentation work.

Public signal160,703 /GitHub repository starsexplicit source
02

writing-plans

Source ↗

Use it forImplementation-aware plans and technical decision documentation.

Avoid ifYou need a broad end-user docs portal.

ContextHigh

Outputunknown

Controlunknown

Agent fitunknown

Watch outDeclared behavior is source-linked, not independently tested.

EvidenceThe skill is explicitly named for writing plans.

Public signal253,385 /GitHub repository starsexplicit source
03

superpowers workflow

Source ↗

Use it forTeams that want documentation linked to planning and implementation workflows.

Avoid ifYou need a single narrow documentation generator.

ContextHigh

Outputunknown

Controlunknown

Agent fitunknown

Watch outDeclared behavior is source-linked, not independently tested.

EvidenceRepository provides a multi-step workflow collection.

Public signal253,385 /GitHub repository starsexplicit source

Still comparing?

Tell us the job, not just the skill names.

Request a task guide