Project docs

Skill cablate/ai-toolkit/skills/project-docs

Battle-tested Claude Code skills for relentless AI delivery

Install

npx -y skills add cablate/ai-toolkit --skill project-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Project documentation structure — standard proj-[name]/ layout with ADRs, stories, and operations guides. Use when: initializing docs for a new project, recording architecture decisions, or maintaining project knowledge bases.

SKILL.md

2.0 KB, as published. Nobody here has run it

Project Documentation

Core Principles

Docs are for future you — Good docs let you resume context in 5 minutes after 3 months away
Record decisions, not just results — "We use X" is not enough. Record "why X, not Y"

Project Docs Structure

Each project gets a proj-[name]/ directory:

proj-[name]/
├── SKILL.md                    # Project entry point (concise summary)
└── references/
    ├── _index.md               # Navigation guide
    ├── product/
    │   ├── vision.md           # What problem this project solves
    │   └── principles.md       # Core development principles
    ├── system/
    │   └── overview.md         # System architecture overview
    ├── decisions/
    │   ├── _index.md           # Decision index
    │   ├── adr/                # Architecture Decision Records
    │   └── stories/            # Feature stories
    └── operations/
        ├── quick-nav.md        # Quick navigation
        └── troubleshooting.md  # Common issues & solutions

Initializing a New Project

Create the directory structure above
Fill product/vision.md — What problem does this project solve?
Define product/principles.md — What are the core development principles?
Document system/overview.md — What does the system look like now?
Backfill decisions/adr/ — Record important technical choices already made

See doc-standards.md for ADR format, story format, and naming conventions.

References

File	Content
doc-standards.md	Document formats and templates