Agent skill

Codebase Onboarding

by affaan-m in affaan-m/ECC

不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。

MITAuto-check passedDevelopment

Install Codebase Onboarding

skills CLI
$ npx skills add affaan-m/ECC --skill codebase-onboarding -a claude-code

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

GitHub CLI
$ gh skill install affaan-m/ECC codebase-onboarding --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/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/ja-JP/skills/codebase-onboarding .claude/skills/codebase-onboarding && 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
codebase-onboarding
GitHub stars
274k
Token cost
~270 tokens
SKILL.md length
22 words
Files
1
Skills in repo
657
Repo updated
First seen
Licence
MIT

At a glance

不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。

  • Tasks that involve Codebase onboarding
  • SKILL.md covers 使用時期 and 動作方法
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Agent instruction files

What it does

Codebase Onboarding is an agent skill from affaan-m/ECC. 不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。

Its SKILL.md is about 270 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Codebase onboarding and Agent instruction files. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Tasks that involve Codebase onboarding
  • Tasks that involve Agent instruction files

Example prompts

  • “/codebase-onboarding”

What it can do on your machine

Read from SKILL.md and the folder at commit ef648e0. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Codebase Onboarding loads about 270 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 22 words of instructions outside code blocks.

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

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

The full file from affaan-m/ECC at commit ef648e0, republished under its MIT licence (© affaan-m). 22 words, ~270 tokens.

Download SKILL.mdSave it as .claude/skills/codebase-onboarding/SKILL.md (or your agent's skills folder).
name
codebase-onboarding
description
不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。
origin
ECC

コードベースオンボーディング

体系的に不慣れなコードベースを分析し、構造化オンボーディングガイドを作成。新しいプロジェクトに参加するか、既存リポでClaude Codeを初めてセットアップする開発者向けに設計。

使用時期

  • Claude Codeでプロジェクトを初めて開く
  • 新しいチームまたはリポに参加
  • ユーザーが「このコードベースを理解する手助けをしてください」と求める
  • ユーザーがプロジェクトのCLAUDE.mdを生成するよう要求
  • ユーザーが「オンボード」または「このリポを説明」と言う

動作方法

フェーズ1:偵察

すべてのファイルを読まずにプロジェクトについての生の信号を集めます。これらのチェックを並行して実行:

1. パッケージマニフェスト検出
   → package.json, go.mod, Cargo.toml, pyproject.toml, pom.xml

2. フレームワークフィンガープリント
   → next.config、nuxt.config、angular.json、vite.config

3. エントリポイント識別
   → main.*、index.*、app.*、server.*

4. ディレクトリ構造スナップショット
   → ディレクトリツリーの最上位2レベル

5. コンフィグとツール検出
   → .eslintrc、.prettierrc、tsconfig.json、Dockerfile

6. テスト構造検出
   → tests/、__tests__/、*.spec.ts、jest.config.*
フェーズ2:アーキテクチャマップ

主要なモジュールとそれらの関係を特定します。

フェーズ3:規約とスタイル

コード規約、命名パターン、プロジェクト固有のパターンを特定。

出力
  • アーキテクチャマップ
  • 主要なエントリポイントと流れ
  • 規約とスタイルガイド
  • スターターCLAUDE.md

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/ja-JP/skills/codebase-onboarding of affaan-m/ECC.

Open the folder on GitHubat commit ef648e0

Compare with similar skills

Codebase Onboarding 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.

Codebase Onboarding compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codebase Onboarding this skillaffaan-m/ECC274k—~270Automated safety check: PassMIT
Init Deep AGENTS.md Generatorcode-yeongyu/oh-my-openagent70k—~3.5kAutomated safety check: PassCustom licence
Drydock Repo Harness SetupYeachan-Heo/oh-my-claudecode40k—~5.2kAutomated safety check: PassMIT
Analyze Codebasedivar-ir/ai-doc-gen765—~899Automated safety check: PassMIT
Hierarchical AGENTS.md GeneratorYeachan-Heo/oh-my-claudecode40k—~2.3kAutomated safety check: PassMIT
Claude Project Bootstrapmp-web3/claude-starter-kit109—~1.9kAutomated safety check: NotesMIT

Similar skills

  • Init Deep AGENTS.md Generator

    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.

    70k GitHub stars~3.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Drydock Repo Harness Setup

    Yeachan-Heo/oh-my-claudecode

    Sets up a shared repo environment for people and agents: CLAUDE.md, a CONTEXT.md glossary, ADRs, standards and a design-system folder, and audits drift with --check.

    40k GitHub stars~5.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Analyze Codebase

    divar-ir/ai-doc-gen

    Run a multi-agent deep analysis of a codebase, producing AI-readable analysis documents in .ai/docs/ covering structure, dependencies, data flow, request flow, and APIs.

    765 GitHub stars~899 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Hierarchical AGENTS.md Generator

    Yeachan-Heo/oh-my-claudecode

    Maps a codebase directory by directory and writes linked AGENTS.md files, each pointing to its parent, to document what each area contains.

    40k GitHub stars~2.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Claude Project Bootstrap

    mp-web3/claude-starter-kit

    Sets up a project for Claude Code by surveying it and writing a .claude folder with a short CLAUDE.md, a CODEBASE.md overview, module docs and optional skills and hooks.

    109 GitHub stars~1.9k tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check: notes
  • Rules Create Global

    coleam00/skills

    Set up your project's global rules, a lean and well-structured root CLAUDE.md (plus a starter .claude/), following the course methodology.

    670 GitHub stars~3.2k tokensUpdated 20 days ago
    Product & Project ManagementAuto-check passed

More from affaan-m/ECC

All 657 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    274k GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Videodb

    affaan-m/ECC

    Ingest, index, search, edit, and monitor video and audio with the VideoDB Python SDK — upload from files, URLs, or RTSP feeds, build spoken and scene indexes with timestamped search and playable…

    274k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    274k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    274k GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Measures whether agents actually follow a skill, rule or agent definition by generating scenarios at three strictness levels and scoring tool-call traces.

    274k GitHub starsUsed in 1 repo~623 tokens
    Auto-check passed
  • Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

    274k GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed

Questions about Codebase Onboarding

What does Codebase Onboarding do?

不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。. Codebase Onboarding is an agent skill from affaan-m/ECC.

When should I use Codebase Onboarding?

Codebase Onboarding fits situations like: tasks that involve Codebase onboarding; tasks that involve Agent instruction files.

How do I install Codebase Onboarding in Claude Code?

Run `npx skills add affaan-m/ECC --skill codebase-onboarding -a claude-code`. Or copy the skill folder (docs/ja-JP/skills/codebase-onboarding in affaan-m/ECC) into .claude/skills/codebase-onboarding in your project. Claude Code loads it when a task matches its description.

How do I install Codebase Onboarding in Codex?

Run `npx skills add affaan-m/ECC --skill codebase-onboarding -a codex`. Or copy the skill folder (docs/ja-JP/skills/codebase-onboarding in affaan-m/ECC) into .agents/skills/codebase-onboarding in your project. Codex loads it when a task matches its description.

Can I use Codebase Onboarding 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 affaan-m/ECC --skill codebase-onboarding -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codebase-onboarding, .gemini/skills/codebase-onboarding, .github/skills/codebase-onboarding and .opencode/skills/codebase-onboarding in your project.

What does Codebase Onboarding need to run?

SKILL.md names no scripts, command-line tools or credentials: Codebase Onboarding is instructions for the agent only.

Does Codebase Onboarding access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codebase Onboarding 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 Codebase Onboarding use?

Codebase Onboarding is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codebase Onboarding use?

About 270 tokens (SKILL.md is roughly 1.1k 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 Codebase Onboarding?

Skills that share tags, products or a category with Codebase Onboarding: Init Deep AGENTS.md Generator (code-yeongyu/oh-my-openagent, 70k stars), Drydock Repo Harness Setup (Yeachan-Heo/oh-my-claudecode, 40k stars), Analyze Codebase (divar-ir/ai-doc-gen, 765 stars) and Hierarchical AGENTS.md Generator (Yeachan-Heo/oh-my-claudecode, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codebase Onboarding?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 274,360 GitHub stars. The repository holds 657 skills in this directory. The repository was last updated on October 5, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.