Agent skill

Init Deep AGENTS.md Generator

by code-yeongyu in code-yeongyu/oh-my-openagent

Generates a tree of AGENTS.md files for a repository, one at the root and more in complex subdirectories, so agents learn its structure and conventions.

Custom licenceAuto-check passedAgent Workflows

Install Init Deep AGENTS.md Generator

skills CLI
$ npx skills add code-yeongyu/oh-my-openagent --skill init-deep -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install code-yeongyu/oh-my-openagent init-deep --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/omo-senpi/skills/init-deep .claude/skills/init-deep && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
init-deep
GitHub stars
70k
Token cost
~3.5k tokens
SKILL.md length
865 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Generates a tree of AGENTS.md files for a repository, one at the root and more in complex subdirectories, so agents learn its structure and conventions.

  • Works in 4 steps: Size & Route → Map Wave - quick Scanners (dag) → Reduce Wave - unspecified-high Writers… → …
  • Documenting a repository's layout, commands and conventions for agents
  • SKILL.md covers Usage, Workflow (High-Level), Phase 1: Size & Route and Phase 2: Map Wave - quick…, plus 8 more sections
  • Calls git and node

What it does

Run as the /init-deep command, this skill measures the repository, scores directories by complexity and writes an AGENTS.md at the root plus one in each subdirectory that earns it. A size formula decides how much work to spread out: small repos are handled inline, larger ones through a map and reduce pipeline in which cheap scanner nodes record facts per chunk and heavier writer nodes each own a separate subtree.

A final node writes the root file from digests alone and another checks every generated file. The main session never reads the scanner reports, only the verdict, which keeps its context small however large the repo is. By default it updates existing files; the --create-new option reads the current ones first, deletes them and regenerates, and --max-depth limits how deep it goes, with a default of 3.

When your agent uses it

  • Documenting a repository's layout, commands and conventions for agents
  • Replacing outdated AGENTS.md files with freshly generated ones
  • Adding AGENTS.md files across a large repository without flooding one session
  • Limiting how many directory levels get their own AGENTS.md

Example prompts

  • “Build AGENTS.md files for this repo with /init-deep.”
  • “Use /init-deep --create-new and rebuild every AGENTS.md from scratch.”
  • “Document the project for agents, but only two directory levels deep: /init-deep --max-depth=2.”

Requirements

  • An omo agent setup with dag task support
  • A repository to scan

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Size & Route
  2. Map Wave - quick Scanners (dag)
  3. Reduce Wave - unspecified-high Writers (same dag)
  4. Root & Verify (same dag)

What it can do on your machine

Read from SKILL.md and the folder at commit cbd7dd2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Init Deep AGENTS.md Generator loads about 3.5k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 865 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 865 words (~3,545 tokens).

“Generate hierarchical AGENTS.md files: root + complexity-scored subdirectories, produced by a size-formula-driven dag map-reduce (quick scanners -> unspecified-high writers) so the main session's context stays flat at any repo size.”

— opening of SKILL.md by code-yeongyu, Custom licence
name
init-deep
argument-hint
[--create-new] [--max-depth=N]

Read the full SKILL.md on GitHub

Files

Just SKILL.md in packages/omo-senpi/skills/init-deep of code-yeongyu/oh-my-openagent.

Open the folder on GitHubat commit cbd7dd2

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in code-yeongyu/oh-my-openagent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Init Deep AGENTS.md Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Init Deep AGENTS.md Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Init Deep AGENTS.md Generator this skillcode-yeongyu/oh-my-openagent70k—~3.5kAutomated safety check: PassCustom licence
Dotagents Standardgetknit/knit130—~4.1kAutomated safety check: PassMIT
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.7k—~938Automated safety check: PassApache-2.0
Repomix Codebase Packeryamadashy/repomix29k—~1.3kAutomated safety check: NotesMIT
Codebase Handbook BuilderRuhan-Wang/Harness_Handbook331—~2.2kAutomated safety check: PassApache-2.0
CodemapJordanCoin/codemap704—~1.8kAutomated safety check: PassMIT

Similar skills

  • Dotagents Standard

    getknit/knit

    Set up, author, and navigate the dotagents standard — a slim AGENTS.md "router" at the repository root plus a hidden .agents/ directory (rules, context, memory, personas, skills, specs, logs, tasks)…

    130 GitHub stars~4.1k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.7k GitHub stars~938 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Repomix Codebase Packer

    yamadashy/repomix

    Packs a local directory or remote GitHub repository into one AI-friendly file with Repomix, then searches it to explore structure, find patterns and count tokens.

    29k GitHub stars~1.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes
  • Codebase Handbook Builder

    Ruhan-Wang/Harness_Handbook

    Generates, refreshes, validates and uses a compact handbook that maps where a change touches in a repository, using the active Codex session and no external LLM API.

    331 GitHub stars~2.2k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Codemap

    JordanCoin/codemap

    Gives an agent a quick map of a codebase's structure, dependencies, changes and handoffs, and tunes per-project config so the output stays code-first.

    704 GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Codebase Search

    Helweg/open-codebase-index

    Chooses the right retrieval tool for code questions: compact context for unfamiliar repos, direct lookup for known symbols, call graphs for relationships and grep for exhaustive matches.

    216 GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from code-yeongyu/oh-my-openagent

All 44 skills in this repo
  • ast-grep Structural Search

    code-yeongyu/oh-my-openagent

    Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.

    70k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Browser Control with Omowright

    code-yeongyu/oh-my-openagent

    Drives a real browser through the omowright library, either the user's own signed-in browser or a separate browser the code launches, for forms, QA, screenshots and scraping.

    70k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • LSP Setup

    code-yeongyu/oh-my-openagent

    Detects which languages a project uses, installs the matching language server, writes its config and checks it with a real call so diagnostics and go-to-definition work.

    70k GitHub stars~1.4k tokensUpdated today
    Auto-check: notes
  • OpenCode QA Toolkit

    code-yeongyu/oh-my-openagent

    Tests the opencode coding agent itself: its CLI, server, plugin hooks and events, the terminal UI under tmux, and its SQLite session database, using tested helper scripts.

    70k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

Questions about Init Deep AGENTS.md Generator

What does Init Deep AGENTS.md Generator do?

Generates a tree of AGENTS.md files for a repository, one at the root and more in complex subdirectories, so agents learn its structure and conventions. md at the root plus one in each subdirectory that earns it. A size formula decides how much work to spread out: small repos are handled inline, larger ones through a map and reduce pipeline in which cheap scanner nodes record facts per chunk and heavier writer nodes each own a separate subtree.

When should I use Init Deep AGENTS.md Generator?

Init Deep AGENTS.md Generator fits situations like: documenting a repository's layout, commands and conventions for agents; replacing outdated AGENTS.md files with freshly generated ones; adding AGENTS.md files across a large repository without flooding one session; limiting how many directory levels get their own AGENTS.md.

How do I install Init Deep AGENTS.md Generator in Claude Code?

Run `npx skills add code-yeongyu/oh-my-openagent --skill init-deep -a claude-code`. Or copy the skill folder (packages/omo-senpi/skills/init-deep in code-yeongyu/oh-my-openagent) into .claude/skills/init-deep in your project. Claude Code loads it when a task matches its description.

How do I install Init Deep AGENTS.md Generator in Codex?

Run `npx skills add code-yeongyu/oh-my-openagent --skill init-deep -a codex`. Or copy the skill folder (packages/omo-senpi/skills/init-deep in code-yeongyu/oh-my-openagent) into .agents/skills/init-deep in your project. Codex loads it when a task matches its description.

Can I use Init Deep AGENTS.md Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add code-yeongyu/oh-my-openagent --skill init-deep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/init-deep, .gemini/skills/init-deep, .github/skills/init-deep and .opencode/skills/init-deep in your project.

What does Init Deep AGENTS.md Generator need to run?

Going by SKILL.md and its folder, Init Deep AGENTS.md Generator needs the command-line tools its instructions call (git and node). Our summary lists: An omo agent setup with dag task support; A repository to scan.

Does Init Deep AGENTS.md Generator access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Init Deep AGENTS.md Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Init Deep AGENTS.md Generator use?

Init Deep AGENTS.md Generator has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Init Deep AGENTS.md Generator use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Init Deep AGENTS.md Generator?

Skills that share tags, products or a category with Init Deep AGENTS.md Generator: Dotagents Standard (getknit/knit, 130 stars), ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.7k stars), Repomix Codebase Packer (yamadashy/repomix, 29k stars) and Codebase Handbook Builder (Ruhan-Wang/Harness_Handbook, 331 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Init Deep AGENTS.md Generator?

code-yeongyu (a GitHub user) maintains it in code-yeongyu/oh-my-openagent, which has 69,850 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 7, 2026.

Source: code-yeongyu/oh-my-openagent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.