init-deep — Hierarchical AGENTS.md Knowledge Base Builder
Scans a repository and auto-generates a hierarchical set of AGENTS.md files at the root and in complexity-scored subdirectories.
Dev & CodingAdvanced★ 67,531⑂ 5,507AI score 9/10Last updated: Aug 9, 2026
What it does
- Fires parallel explore agents (structure, entry points, conventions, anti-patterns, build/CI, tests) while the main session runs
find/awkstructural analysis, LSP/codegraph symbol mapping, and reads any existing AGENTS.md or CLAUDE.md. - Applies a weighted scoring matrix (file count 3x, subdirs 2x, code ratio, symbol density, reference centrality 3x) to decide where AGENTS.md belongs: >15 always create, 8–15 create if a distinct domain, <8 skip.
- Writes a root document with fixed sections (OVERVIEW, STRUCTURE, WHERE TO LOOK, CODE MAP, CONVENTIONS, ANTI-PATTERNS, COMMANDS) capped at 50–150 lines, child docs at 30–80 lines, then a review pass strips generic advice and parent duplication.
- Uses Edit (never blind Write) for existing files, and even in
--create-newmode reads old content before deleting it.
Who it's for
- Developers who want an AI-readable knowledge base on an undocumented medium-to-large codebase.
- Teams on monorepos or polyglot repos that need per-package conventions documented separately.
- Users already running the Codex/OMO harness with multi-agent, codegraph and LSP tooling.
Examples
/init-deep— update mode: refresh existing docs and add new ones only where the score warrants./init-deep --create-new— absorb existing docs for context, delete them all, regenerate from scratch./init-deep --max-depth=2— cap depth on a large tree to avoid over-documenting.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/packages/omo-codex/plugin/skills/init-deep/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the packages/omo-codex/plugin/skills/init-deep folder from the GitHub repo code-yeongyu/oh-my-openagent into my ~/.claude/skills/init-deep/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/code-yeongyu/oh-my-openagent.git && cp -r oh-my-openagent/packages/omo-codex/plugin/skills/init-deep ~/.claude/skills/init-deep⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and move to your working directory.
- Clone the repo:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - Copy the skill:
mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/omo-codex/plugin/skills/init-deep ~/.claude/skills/init-deep - Confirm
~/.claude/skills/init-deep/SKILL.mdexists. - Restart Claude Code, then run
/init-deepor ask it to "use the init-deep skill to build AGENTS.md". - Without codegraph/LSP tools, the skill falls back to explore agents plus ast-grep and marks centrality as unmeasured in the CODE MAP.
View source on GitHub ↗License: NOASSERTION