AI Skill MartBrowse skillsPromptsProgramsLearnWhat is a Skill?
← Back to list

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/awk structural 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-new mode 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

  1. /init-deep — update mode: refresh existing docs and add new ones only where the score warrants.
  2. /init-deep --create-new — absorb existing docs for context, delete them all, regenerate from scratch.
  3. /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)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI 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.

  1. Open a terminal and move to your working directory.
  2. Clone the repo: git clone https://github.com/code-yeongyu/oh-my-openagent.git
  3. Copy the skill: mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/omo-codex/plugin/skills/init-deep ~/.claude/skills/init-deep
  4. Confirm ~/.claude/skills/init-deep/SKILL.md exists.
  5. Restart Claude Code, then run /init-deep or ask it to "use the init-deep skill to build AGENTS.md".
  6. 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