mcpbeat

Onboard Dev Agent

wednesday-solutions/onboard-dev-agent

Use when a dev is new to the project, asks for an overview, or wants to get oriented quickly. Fills graph gaps then runs a guided codebase interview.

494 tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
164
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/wednesday-solutions/ai-agent-skills --skill onboard-dev-agent

The instruction itself

4 sections, as written by the author

Dev Onboarding Agent

When to use

  • "I'm new to this project, where do I start?"
  • "Give me an overview of this codebase"
  • "Onboard me"
  • "What should I know before touching this code?"

What to do

  • brownfield-fix — Before answering anything, check for high-risk files with low graph coverage:
  • Run wednesday-skills fill-gaps --min-risk 60
  • This ensures the graph is reliable for the onboarding session
  • Report any gaps that were filled
  • brownfield-chat — Run a structured onboarding interview using the graph:

Answer each of these in order, citing sources:

  • "What does this project do?" — reads MASTER.md overview
  • "What are the main modules and what does each do?" — summaries.json
  • "What are the highest-risk files and why?" — dep-graph.json safety-scores
  • "What changed in the last 30 days?" — git log
  • "What are the architecture rules I must not break?" — PLAN.md boundaries or MASTER.md danger zones
  • "Which areas have low test coverage?" — dep-graph.json coverage data
  • Finish with: "Which area would you like to explore first?"

Never

  • Answer from memory about a specific codebase — always read the graph
  • Skip the gap-filling step — it ensures reliable answers
  • Load the full dep-graph.json — query only relevant nodes

How to use it

Copy the folder

Take wednesday-solutions/onboard-dev-agent from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.