Claude MarketplacesSubmit
broomva avatar

Harness Engineering Playbook

broomva/harness-engineering-skill

This is a structured way to make any repo work reliably with autonomous agents. It scaffolds the artifacts OpenAI recommends in their Harness Engineering guide: AGENTS.md and PLANS.md for context, deterministic Makefile commands so agents can test and lint without surprises, architecture boundaries to prevent overstep, and observability hooks from the start. You get three profiles depending on how much discipline you want baked in. The audit command treats missing practices as blocking, which is the right default. If you're building something agents will touch repeatedly, this gives you the guard rails and documentation structure to keep runs from diverging into chaos.

skills.sh installs
214
GitHub stars
26
last updated
Jun 3, 2026
View on GitHub

Install

$ npx -y skills add broomva/harness-engineering-skill --skill harness-engineering-playbook --agent claude-code

Installs into .claude/skills of the current project.

Files

Harness Engineering Playbook

Use this skill to operationalize the practices from OpenAI's Harness Engineering guide in a repo that agents can run against repeatedly and safely.

What To Load

  • Use references/openai-harness-practices.md for the full practice-to-artifact mapping.
  • Use references/rollout-checklist.md for phased adoption in active repos.
  • Use references/wizard-cli.md for Typer wizard command flows.
  • Use assets/templates/ when creating or updating harness files.

Inputs

  • Target repository path.
  • Existing command surface (make, npm, cargo, pytest, etc.).
  • Existing CI workflows and branch protections.

Workflow

  1. Baseline the repo and detect existing workflows.
  2. Bootstrap harness artifacts and templates.
  3. Apply all nine Harness Engineering practices.
  4. Run harness audit checks and repair gaps.
  5. Iterate after real agent runs.

Step 1: Baseline The Repo

  • Identify language/toolchain and canonical entrypoints.
  • Inventory existing checks, scripts, and CI jobs.
  • Record current pain points for agent runs: setup drift, unclear docs, flaky tests, missing trace IDs, slow loops.
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/broomva/harness-engineering-skill
First seen
Jun 3, 2026

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs