claude-docs-init

Generate repository docs and CLAUDE.md for Claude Code navigation.

2|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/lestrrat/claude-code --skill claude-docs-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-docs-init
Source: https://github.com/lestrrat/claude-code/tree/main/skills/claude-docs-init
Command: npx skills add https://github.com/lestrrat/claude-code --skill claude-docs-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize .claude/docs/ and CLAUDE.md for a repository. Analyzes the codebase and creates agent-optimized documentation so Claude Code can navigate, modify, and test the project effectively.

Core Features & Use Cases

  • Generate core docs (packages.md, testing.md, dependencies.md) to map project structure and testing landscape.
  • Generate ecosystem-specific docs based on detected language (Go, Node, Python, etc.) to cover APIs, configurations, and architecture.
  • Produce CLAUDE.md with pre-read rules and cache maintenance, enabling agent sessions to operate with up-to-date repo context.

Quick Start

Analyze the repository and generate CLAUDE-docs artifacts for immediate agent readiness.

Frequently Asked Questions about claude-docs-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate agent-optimized documentation for my codebase to help Claude Code navigate projects?

Agent-optimized documentation is generated by analyzing the repository root to determine language ecosystem, build system, project structure, tests, and CI/CD, producing core docs and a CLAUDE.md file for Claude Code.

What is the best way to set up CLAUDE.md pre-read rules for repository context?

Setting up CLAUDE.md pre-read rules involves generating a file with cache maintenance instructions that enables agent sessions to operate with up-to-date repository context and navigation rules.

Can I automatically map project structure and testing landscapes for different language ecosystems like Go or Python?

Yes, the repository analysis detects the language ecosystem and generates ecosystem-specific docs covering APIs, configurations, and architecture alongside core docs like packages.md and testing.md.

How do I keep repository documentation in sync with source code changes?

Keeping docs in sync with source changes is handled by the generated CLAUDE.md cache maintenance rules, which ensure agent sessions operate with up-to-date repository context during modifications.

Do I need existing documentation to bootstrap agent-ready repository docs?

No, existing documentation is not required. The tool analyzes the codebase structure, build system, and CI/CD configuration to generate core docs and ecosystem-specific documentation from scratch.

What documentation files are generated to map project dependencies and structure?

The generated core documentation files include packages.md, testing.md, and dependencies.md to map the project structure, testing landscape, and dependency ecosystem for agent navigation.