Doc Init

Bootstraps a business-domain (not folder-based) doc system for AI coding agents, with a machine-checked staleness gate.

von x0c · x0c/doc-skills

Getestet · Funktioniert ★ 9.6/10

Doc Init — Bootstraps a business-domain (not folder-based) doc system for AI coding agents, with a machine-checked staleness gate.

Was es kann

Two-phase project documentation initializer for AI coding agents: first patches the user's global CLAUDE.md/AGENTS.md with a versioned doc-governance standard, then scans the repo (language stack, git history, optional DB catalog) to build business-domain knowledge bases with a coverage gate that flags docs as STALE once the codebase drifts past a fingerprinted baseline. Triggers on brand-new projects with no doc structure or when the global instruction file lacks the governance section; explicitly hands off incremental updates to a sibling doc-update skill and doc bloat cleanup to doc-compact.

Testbericht

Ran the real scripts end-to-end on a throwaway git fixture: project_inventory.py correctly flagged src/auth/login.js as a permissions-dictionary candidate, doc_coverage.py correctly flipped COMPLETE->STALE when file count grew past the 25% drift threshold, and the generated knowledge-base doc caught a real mutation side-effect (markPaid mutates its argument in place) that a hand-written baseline doc completely missed. Notable: Phase 1 auto-patches the user's *global* CLAUDE.md/AGENTS.md file (tested only against a throwaway copy, never the real one) — disclosed prominently, versioned, and idempotent, not covert, but worth knowing before running for real.

Getestet am: 2026-07-15 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/x0c/doc-skills
cd doc-skills
mkdir -p ~/.claude/skills
cp -r doc-init ~/.claude/skills/doc-init

Befehle & Beispiel-Prompts

  • /doc-initBootstraps a business-domain (not folder-based) doc system for AI coding agents, with a machine-checked staleness gate.

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • This repo has zero documentation, set up a proper doc system for it
  • We just cloned this codebase with no AGENTS.md, bootstrap our knowledge base
  • Bootstrap business-domain docs for this project before we onboard engineers