Agent skill

Setup Codebase Harness

by AI-Builder-Club in AI-Builder-Club/skills

Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a…

No licenceAuto-check passedTesting & QA

Install Setup Codebase Harness

skills CLI
$ npx skills add AI-Builder-Club/skills --skill setup-codebase-harness -a claude-code

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

GitHub CLI
$ gh skill install AI-Builder-Club/skills setup-codebase-harness --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/AI-Builder-Club/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/setup-codebase-harness .claude/skills/setup-codebase-harness && 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
setup-codebase-harness
GitHub stars
1.3k
Token cost
~1.4k tokens
SKILL.md length
696 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
None found

At a glance

Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a…

  • Works in 5 steps: Assess → Legible — the agent can reason about the… → Executable — the agent can run & drive… → …
  • Onboarding a new/unfamiliar codebase to agent-driven development — set up the harness
  • SKILL.md covers 0. Assess, 1. Legible — the agent can…, 2. Executable — the agent can… and 3. Verifiable — the agent can…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Setup Codebase Harness is an agent skill from AI-Builder-Club/skills. Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a verify-before-ship loop), plus commit hygiene and entropy control. Use when onboarding a new/unfamiliar codebase to agent-driven development — "set up the harness", "make this repo agent-ready", "harness this codebase".

Its SKILL.md is about 1.4k 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 Testing & QA, covering Linting and formatting and End-to-end testing. The repository describes itself as: Codebase harness + loop engineer.

When your agent uses it

  • Onboarding a new/unfamiliar codebase to agent-driven development — set up the harness
  • Make this repo agent-ready
  • Harness this codebase

Example prompts

  • “set up the harness”
  • “make this repo agent-ready”
  • “harness this codebase”
  • “/setup-codebase-harness”

Requirements

  • Docker

Workflow steps

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

  1. Assess
  2. Legible — the agent can reason about the repo
  3. Executable — the agent can run & drive the app
  4. Verifiable — the agent can prove it works
  5. Others — keep it coherent over time

What it can do on your machine

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

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Setup Codebase Harness loads about 1.4k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 696 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 696 words (~1,417 tokens).

“Harness engineering: the model is fixed — what you engineer is the scaffolding around it (the environment, the docs, the feedback loops) so an agent can build and verify software with minimal human attention. Humans steer; agents execute. Your job…”

— opening of SKILL.md by AI-Builder-Club
name
setup-codebase-harness
user_invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/setup-codebase-harness of AI-Builder-Club/skills.

Open the folder on GitHubat commit 917780c

Compare with similar skills

Setup Codebase Harness 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.

Setup Codebase Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup Codebase Harness this skillAI-Builder-Club/skills1.3k—~1.4kAutomated safety check: PassNone
Acceptance Test Authoringintent-driven-dev/intent-driven-template161—~2kAutomated safety check: PassMIT
Odc DebuggingDouglasNeuroInformatics/OpenDataCapture119—~2.8kAutomated safety check: NotesApache-2.0
Verifyjh941213/my-cc-harness125—~1.1kAutomated safety check: NotesNone
Pierre Testing and Verification Guidepierrecomputer/pierre6.3k—~608Automated safety check: PassApache-2.0
Ha Frontend Testinghome-assistant/frontend5.7k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Acceptance Test Authoring

    intent-driven-dev/intent-driven-template

    A skill your agent uses when creating or modifying acceptance tests, configuring cucumber-js or behave runners, writing or refactoring step definitions, linting executable Gherkin specs, choosing an…

    161 GitHub stars~2k tokensUpdated 6 days ago
    Testing & QAAuto-check passed
  • Odc Debugging

    DouglasNeuroInformatics/OpenDataCapture

    What actually breaks in Open Data Capture — a failing build, lint, unit test or e2e run; a change with no visible effect; a suite that stays green after you broke the code on purpose; an error…

    119 GitHub stars~2.8k tokensUpdated 2 days ago
    Testing & QAAuto-check: notes
  • Verify

    jh941213/my-cc-harness

    Code verification after task completion (typecheck, lint, test, build).

    125 GitHub stars~1.1k tokensUpdated 2 mo ago
    Testing & QAAuto-check: notes
  • Chooses the right verification step after a code change in Pierre's monorepo: format and lint, a typecheck, Bun unit tests, snapshots, or Playwright E2E.

    6.3k GitHub stars~608 tokensUpdated today
    Testing & QAAuto-check passed
  • Ha Frontend Testing

    home-assistant/frontend

    Home Assistant frontend testing and validation workflow. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Precommit

    ploxc/modbux

    Run the checklist before committing or merging — read the diff, lint, typecheck, the unit suite, the e2e specs the change touches, then report and commit.

    110 GitHub stars~1.5k tokensUpdated 2 days ago
    Testing & QAAuto-check passed

More from AI-Builder-Club/skills

All 11 skills in this repo
  • Visual Flow Gif

    AI-Builder-Club/skills

    Create animated flow diagrams from articles, workflow notes, architecture sketches, or process descriptions using a JSON specification and a local Python/Pillow renderer.

    1.3k GitHub stars~845 tokensUpdated 24 days ago
    Auto-check passed
  • Karaoke Captions

    AI-Builder-Club/skills

    Generate TikTok/Shorts-style karaoke captions using MLX Whisper, ASS subtitles, and FFmpeg libass.

    1.3k GitHub stars~850 tokensUpdated 24 days ago
    Auto-check passed
  • Open Agent Teams

    AI-Builder-Club/skills

    Delegate tasks to ANY CLI agent (claude, codex, aider, ...) running in a detached tmux session, with a race-safe done-signal protocol and multi-turn iteration.

    1.3k GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed
  • New Loop

    AI-Builder-Club/skills

    Spin up a new loop (domain) in a file-based knowledge base — bootstrap the substrate if it's missing, gather the loop's charter, scaffold domains/<loop/README.md, then do ONE real test run and…

    1.3k GitHub stars~1.2k tokensUpdated 24 days ago
    Auto-check: notes
  • Crabbox Setup

    AI-Builder-Club/skills

    Scaffold an isolated CLOUD dev box per agent (via crabbox + Daytona) for any codebase — the parallel-safe counterpart to dev-local-setup.

    1.3k GitHub stars~1.9k tokensUpdated 24 days ago
    Auto-check: notes
  • SEO Growth

    AI-Builder-Club/skills

    A skill your agent uses when deciding WHERE to point SEO effort, not how to write a page.

    1.3k GitHub stars~1.9k tokensUpdated 24 days ago
    Auto-check passed

Questions about Setup Codebase Harness

What does Setup Codebase Harness do?

Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a…. Setup Codebase Harness is an agent skill from AI-Builder-Club/skills. Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a verify-before-ship loop), plus commit hygiene and entropy control.

When should I use Setup Codebase Harness?

Setup Codebase Harness fits situations like: onboarding a new/unfamiliar codebase to agent-driven development — set up the harness; make this repo agent-ready; harness this codebase.

How do I install Setup Codebase Harness in Claude Code?

Run `npx skills add AI-Builder-Club/skills --skill setup-codebase-harness -a claude-code`. Or copy the skill folder (skills/setup-codebase-harness in AI-Builder-Club/skills) into .claude/skills/setup-codebase-harness in your project. Claude Code loads it when a task matches its description.

How do I install Setup Codebase Harness in Codex?

Run `npx skills add AI-Builder-Club/skills --skill setup-codebase-harness -a codex`. Or copy the skill folder (skills/setup-codebase-harness in AI-Builder-Club/skills) into .agents/skills/setup-codebase-harness in your project. Codex loads it when a task matches its description.

Can I use Setup Codebase Harness 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 AI-Builder-Club/skills --skill setup-codebase-harness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-codebase-harness, .gemini/skills/setup-codebase-harness, .github/skills/setup-codebase-harness and .opencode/skills/setup-codebase-harness in your project.

What does Setup Codebase Harness need to run?

SKILL.md names no scripts, command-line tools or credentials: Setup Codebase Harness is instructions for the agent only. Our summary lists: Docker.

Does Setup Codebase Harness access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

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

No licence was found for Setup Codebase Harness or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Setup Codebase Harness use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 Setup Codebase Harness?

Skills that share tags, products or a category with Setup Codebase Harness: Acceptance Test Authoring (intent-driven-dev/intent-driven-template, 161 stars), Odc Debugging (DouglasNeuroInformatics/OpenDataCapture, 119 stars), Verify (jh941213/my-cc-harness, 125 stars) and Pierre Testing and Verification Guide (pierrecomputer/pierre, 6.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Codebase Harness?

AI-Builder-Club (a GitHub organization) maintains it in AI-Builder-Club/skills, which has 1,288 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 15, 2026.

Source: AI-Builder-Club/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.