init-deep

Generate hierarchical AGENTS.md documentation with paired CLAUDE.md files.

270|17|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/AkaraChen/aghub --skill init-deep-akarachen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-deep
Source: https://github.com/AkaraChen/aghub/tree/main/.claude/skills/init-deep
Command: npx skills add https://github.com/AkaraChen/aghub --skill init-deep-akarachen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically generate a hierarchical set of AGENTS.md files that document codebases and ensure every AGENTS.md has a paired CLAUDE.md, including a root index and per-directory pages. It streamlines knowledge capture for monorepos and multi-package projects and keeps documentation in sync as the project evolves.

Core Features & Use Cases

  • Generates a root AGENTS.md plus per-directory AGENTS.md pages and automatically creates a CLAUDE.md pairing (via symlink or rename) in the same directory.
  • Supports update mode and a --create-new option to regenerate from scratch, as well as depth control (--max-depth) to limit scope.
  • Applies to monorepos and multi-package codebases, enabling consistent documentation across the entire project.

Quick Start

Run /init-deep to update existing AGENTS.md/CLAUDE.md pairs across the project, or use /init-deep --create-new to regenerate from scratch.

Frequently Asked Questions about init-deep

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

FAQPage Schema
How do I automatically generate hierarchical AGENTS.md documentation for a monorepo?

It works by generating a root AGENTS.md and per-directory pages, then creating a paired CLAUDE.md via symlink or rename in the same directory to keep documentation consistently paired.

How do I pair CLAUDE.md files with AGENTS.md across my codebase directories?

It works by generating a root AGENTS.md and per-directory pages, then creating a paired CLAUDE.md via symlink or rename in the same directory to keep documentation consistently paired.

Can I limit the documentation generation depth for subdirectories in a monorepo?

You can update existing pairs by running the default command, or use the --create-new option to regenerate all AGENTS.md and CLAUDE.md files from scratch across the entire project.

How do I update or completely regenerate existing AGENTS.md and CLAUDE.md pairs?

You can update existing pairs by running the default command, or use the --create-new option to regenerate all AGENTS.md and CLAUDE.md files from scratch across the entire project.

Does generating a knowledge base of AGENTS.md files support update mode without overwriting existing content?

Yes, the default update mode reads existing AGENTS.md and CLAUDE.md files to modify them, while the --create-new option overwrites and regenerates the complete hierarchical documentation structure.