Skip to content

jeffabailey/jbb-skills

v1.7.1Unlicense

Project fitness review skills (architecture, security, reliability, testing, performance, algorithms, data, accessibility, usability, process, maintainability) plus commit, root-cause, AI-tell cleanup, and fitness-config setup helpers.

button-up-documentation

Tidies a repo's documentation. By default collapses the design docs in docs/architecture/ into ADRs in docs/adrs/ (one decision per ADR, in the repo's own ADR format), deletes docs that are stale, duplicated, or leftover working notes, repoints links, and tightens the prose that stays with Strunk & White's rules. A tidy-only mode cleans prose and removes dead docs without touching ADRs. Then offers the same cleanup for README.md, CONTRIBUTING.md, and other docs. A bundled script inventories the docs and checks links; the skill shows a plan and waits for approval before it edits or deletes anything. Use when the user says /jbb-skills:button-up-documentation, asks to button up, clean up, consolidate, prune, or tidy docs, wants architecture or design docs turned into ADRs, asks which docs are stale or redundant, or wants a README or CONTRIBUTING tightened, even if they don't say 'ADR'.

Version
1.0.0
Read SKILL.md at the source

Pinned to revision 7a3741bdc38f, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.