repo-onboarding · hoangsonww — Claude Code skill: what it does, how to install
repo-onboarding guides AI coding agents through codebase architecture, layer selection, and test command discovery before editing.
MIT ★ 1,198 updated 2026-10-23
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a claude-codeWhat repo-onboarding does
The skill outlines a disciplined onboarding sequence for unfamiliar repositories. The agent inspects AGENTS.md, README.md, and ARCHITECTURE.md first, then isolates the target layer among server/, client/, mcp/, or documentation. This structure keeps modifications confined to the smallest viable file set.
Verification precedes editing. Default scripts include npm run test:server for backend work, npm run test:client for the frontend, plus npm run mcp:typecheck and npm run mcp:build for MCP tooling. Without references/module-map.md and references/verification-map.md present in the repo, context mapping loses its reference anchors.
What it helps with
- map repository architecture prior to writing code
- isolate target layers across server, client, and MCP modules
- identify minimal file sets needed for a feature
- pinpoint test commands before editing files
Example prompts for the agent
- Run repo-onboarding to plan changes for the client/ directory
- Inspect the repository layout and find verification commands for mcp/
- Analyze the codebase architecture using AGENTS.md and ARCHITECTURE.md
How to install repo-onboarding
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a claude-code2Manually: put the files in place
~/.claude/skills/repo-onboarding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/repo-onboarding/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a codex2Manually: put the files in place
.agents/skills/repo-onboarding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a cursor2Manually: put the files in place
.cursor/skills/repo-onboarding/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor .agents/skills/repo-onboarding2Manually: put the files in place
.github/skills/repo-onboarding/SKILL.md1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .agents/skills/repo-onboardingManually: put the files in place
.devin/skills/repo-onboarding/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about repo-onboarding
How to install repo-onboarding in Claude Code?
Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill repo-onboarding -a claude-code. The file will be placed in ~/.claude/skills/repo-onboarding/SKILL.md.
What does repo-onboarding do?
It directs the agent to scan core architecture documents, isolate the relevant codebase layer, and pick testing scripts before editing files.
Which default test commands does this skill set up?
It configures npm run test:server for the server, npm run test:client for frontend code, and npm run mcp:typecheck alongside npm run mcp:build for MCP layers.
Source text
SKILL.md · MIT
--- name: repo-onboarding description: Understand this repository quickly before making changes. Use for architecture discovery, ownership mapping, command selection, and initial implementation planning. --- # Repo Onboarding Skill ## Workflow - Read `AGENTS.md`, `README.md`, and `ARCHITECTURE.md`. - Determine target layer: `server/`, `client/`, `mcp/`, or docs. - Identify the minimal file set needed for the task. - Select verification commands before editing. ## Verification defaults - Backend: `npm run test:server` - Frontend: `npm run test:client` - MCP: `npm run mcp:typecheck` and `npm run mcp:build` ## References - `references/module-map.md` - `references/verification-map.md`
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor
Similar skills
All skills for Agent setup: memory, context, orchestration →repo-onboarding by other authors comes first.