Project docs

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

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.From its SKILL.md

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

15 stars15 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.

SKILL.md

2.0 KB, 386 tokens by cl100k_base, 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

What ships with it: 1 file

1.1 KB alongside SKILL.md

references/

doc-standards.md1.1 KB