Adopt Project

Audits an existing codebase and retrofits agent-starter's hooks, lint configs, and patterns, tier by tier, with approval gates.

Works with setup

Test report

Verdict
Works with setup
Score
9.2/10
Tested
Jul 16, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 4211a9a

The audit phase is genuinely useful and was run for real against a throwaway Python project (caught a bare except:, a swallowed exception, and a direct os.environ read with exact line numbers) -- but Tiers 1-4 of the Propose/Apply phases all pull from '<repo-path>/hooks', '<repo-path>/templates', and '<repo-path>/guides', none of which exist in the standalone skill folder, so a bare `cp -r skills/adopt-project` install only gets you the interview+audit, not the actual retrofit, unless you keep a full separate clone of agent-starter around and hand it the path.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 4/5
  • Triggers reliably 5/5
  • Output vs. baseline 9/10
  • Docs & honesty 5/5

What Adopt Project does

Runs a read-only audit of an existing project (stack, lint config, CLAUDE.md, tests, file-size health, error-handling patterns), then proposes agent-starter components grouped by invasiveness (hooks/skills/CLAUDE.md/lint/code patterns) and applies only what the developer explicitly approves, tier by tier, on a dedicated branch. Triggers on "adopt," "retrofit," or "apply agent-starter to this project." Requires a separately-cloned copy of the full agent-starter repo (not just this skill folder) to actually copy hooks/templates/guides in Tiers 1-4.

How to install Adopt Project

git clone https://github.com/sneg55/agent-starter
cd agent-starter
mkdir -p ~/.claude/skills
cp -r skills/adopt-project ~/.claude/skills/adopt-project

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Adopt Project

  • /adopt-project Audits an existing codebase and retrofits agent-starter's hooks, lint configs, and patterns, tier by tier, with approval gates.

It also activates on plain-language prompts like these:

  • Audit this existing codebase and propose which starter hooks to adopt
  • Retrofit my repo with lint configs and error-handling patterns from the kit
  • Apply agent-starter conventions to this project, but ask before each tier

Frequently asked questions

Is the Adopt Project skill free?
Yes. The skill itself is free from sneg55/agent-starter. SkillProof publishes the install command and an independent test verdict at no cost.
Does Adopt Project work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 16, 2026. Verdict: Works with setup. The audit phase is genuinely useful and was run for real against a throwaway Python project (caught a bare except:, a swallowed exception, and a direct os.environ read with exact line numbers) -- but Tiers 1-4 of the Propose/Apply phases all pull from '<repo-path>/hooks', '<repo-path>/templates', and '<repo-path>/guides', none of which exist in the standalone skill folder, so a bare `cp -r skills/adopt-project` install only gets you the interview+audit, not the actual retrofit, unless you keep a full separate clone of agent-starter around and hand it the path.
What is the Adopt Project SkillProof Score?
9.2/10 — installs cleanly 4/5, triggers reliably 5/5, output vs. baseline 9/10, docs & honesty 5/5.
How do I install Adopt Project?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Adopt Project with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.