{"id":"5dd64a10-bc87-41c1-9c63-4c85967349b1","shortId":"zcZf4e","kind":"skill","title":"harness-engineering-playbook","tagline":"Implement OpenAI Harness Engineering practices in any repository — AGENTS.md, PLANS.md, deterministic smoke/test/lint harness commands, strict architecture boundaries, observability from day 1, and entropy-control audits for reliable autonomous agent runs.","description":"# Harness Engineering Playbook\n\nA skills.sh-compatible skill that operationalizes the practices from OpenAI's Harness Engineering guide. Use it to set up or refactor agent-first workflows so that autonomous runs are repeatable, observable, and safe.\n\n## Install\n\n```bash\nnpx skills add broomva/harness-engineering-skill --skill harness-engineering-playbook\n```\n\n## What It Does\n\n- Bootstraps harness artifacts: `AGENTS.md`, `PLANS.md`, `docs/ARCHITECTURE.md`, `docs/OBSERVABILITY.md`, `Makefile.harness`, and CI workflows.\n- Wraps deterministic commands behind `make smoke`, `make check`, `make ci` so agents can run them reliably.\n- Enforces strict module boundaries and data-shape contracts.\n- Wires structured observability (correlation IDs, key transitions) from day 1.\n- Adds entropy-control audits and nightly harness checks to prevent docs drift and flaky scripts.\n\n## Workflow\n\n1. **Baseline** the target repo — detect language, toolchain, and existing CI.\n2. **Bootstrap** harness artifacts from templates (interactive wizard or shell script).\n3. **Apply** the nine Harness Engineering practices across repo artifacts.\n4. **Validate** with `audit` — treat any `MISSING` or `FAIL` as blocking.\n5. **Iterate** after real agent runs — patch gaps and re-audit.\n\n## Quick Start\n\n```bash\n# Interactive wizard (recommended)\npython3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py init <repo-path> --profile control\n\n# Shell fallback\n./scripts/bootstrap_harness.sh <repo-path>\n\n# Audit\npython3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py audit <repo-path>\n```\n\n## Profiles\n\n| Profile    | Scope                                              |\n|------------|----------------------------------------------------|\n| `baseline` | Core harness artifacts only                        |\n| `control`  | Baseline + control-system primitives               |\n| `full`     | Control + entropy controls, nightly audit, CI      |\n\n## Source\n\nOpenAI Harness Engineering guide: <https://openai.com/index/harness-engineering/>\n\n## License\n\nMIT","tags":["harness","engineering","broomva","agent-skills","autonomous-agents","bstack-foundation","ci-cd","developer-tools","harness-engineering","openai-codex","skills-sh"],"capabilities":["skill","source-broomva","skill-harness-engineering","topic-agent-skills","topic-autonomous-agents","topic-bstack-foundation","topic-ci-cd","topic-developer-tools","topic-harness-engineering","topic-openai-codex","topic-skills-sh"],"categories":["harness-engineering"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/broomva/harness-engineering","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add broomva/harness-engineering","source_repo":"https://github.com/broomva/harness-engineering","install_from":"skills.sh"}},"qualityScore":"0.460","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 21 github stars · SKILL.md body (2,073 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T19:06:11.488Z","embedding":null,"createdAt":"2026-04-19T00:38:36.782Z","updatedAt":"2026-04-22T19:06:11.488Z","lastSeenAt":"2026-04-22T19:06:11.488Z","tsv":"'/index/harness-engineering/':251 '/scripts/bootstrap_harness.sh':218 '1':25,132,150 '2':161 '3':172 '4':182 '5':193 'across':179 'add':77,133 'agent':34,61,109,197 'agent-first':60 'agents.md':13,90 'agents/skills/harness-engineering-playbook/scripts/harness_wizard.py':212,221 'appli':173 'architectur':20 'artifact':89,164,181,229 'audit':30,137,185,204,219,222,242 'autonom':33,66 'baselin':151,226,232 'bash':74,207 'behind':101 'block':192 'bootstrap':87,162 'boundari':21,117 'broomva/harness-engineering-skill':78 'check':105,141 'ci':96,107,160,243 'command':18,100 'compat':41 'contract':122 'control':29,136,215,231,234,238,240 'control-system':233 'core':227 'correl':126 'data':120 'data-shap':119 'day':24,131 'detect':155 'determinist':15,99 'doc':144 'docs/architecture.md':92 'docs/observability.md':93 'drift':145 'enforc':114 'engin':3,8,37,51,82,177,247 'entropi':28,135,239 'entropy-control':27,134 'exist':159 'fail':190 'fallback':217 'first':62 'flaki':147 'full':237 'gap':200 'guid':52,248 'har':2,7,17,36,50,81,88,140,163,176,228,246 'harness-engineering-playbook':1,80 'id':127 'implement':5 'init':213 'instal':73 'interact':167,208 'iter':194 'key':128 'languag':156 'licens':252 'make':102,104,106 'makefile.harness':94 'miss':188 'mit':253 'modul':116 'night':139,241 'nine':175 'npx':75 'observ':22,70,125 'openai':6,48,245 'openai.com':250 'openai.com/index/harness-engineering/':249 'operation':44 'patch':199 'plans.md':14,91 'playbook':4,38,83 'practic':9,46,178 'prevent':143 'primit':236 'profil':214,223,224 'python3':211,220 'quick':205 're':203 're-audit':202 'real':196 'recommend':210 'refactor':59 'reliabl':32,113 'repeat':69 'repo':154,180 'repositori':12 'run':35,67,111,198 'safe':72 'scope':225 'script':148,171 'set':56 'shape':121 'shell':170,216 'skill':42,76,79 'skill-harness-engineering' 'skills.sh':40 'smoke':103 'smoke/test/lint':16 'sourc':244 'source-broomva' 'start':206 'strict':19,115 'structur':124 'system':235 'target':153 'templat':166 'toolchain':157 'topic-agent-skills' 'topic-autonomous-agents' 'topic-bstack-foundation' 'topic-ci-cd' 'topic-developer-tools' 'topic-harness-engineering' 'topic-openai-codex' 'topic-skills-sh' 'transit':129 'treat':186 'use':53 'valid':183 'wire':123 'wizard':168,209 'workflow':63,97,149 'wrap':98","prices":[{"id":"c8df5284-4df1-48c5-88b2-63a5945725b5","listingId":"5dd64a10-bc87-41c1-9c63-4c85967349b1","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"broomva","category":"harness-engineering","install_from":"skills.sh"},"createdAt":"2026-04-19T00:38:36.782Z"}],"sources":[{"listingId":"5dd64a10-bc87-41c1-9c63-4c85967349b1","source":"github","sourceId":"broomva/harness-engineering","sourceUrl":"https://github.com/broomva/harness-engineering","isPrimary":false,"firstSeenAt":"2026-04-19T00:38:36.782Z","lastSeenAt":"2026-04-22T19:06:11.488Z"}],"details":{"listingId":"5dd64a10-bc87-41c1-9c63-4c85967349b1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"broomva","slug":"harness-engineering","github":{"repo":"broomva/harness-engineering","stars":21,"topics":["agent-skills","autonomous-agents","bstack-foundation","ci-cd","developer-tools","harness-engineering","openai-codex","skills-sh"],"license":"mit","html_url":"https://github.com/broomva/harness-engineering","pushed_at":"2026-03-18T18:55:45Z","description":"Harness Engineering playbook — deterministic smoke/test/lint harness commands, strict architecture boundaries, entropy-control checks for autonomous agent workflows.","skill_md_sha":"dce584821155204541c69a25396d95a5e5561651","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/broomva/harness-engineering"},"layout":"root","source":"github","category":"harness-engineering","frontmatter":{"name":"harness-engineering-playbook","description":"Implement OpenAI Harness Engineering practices in any repository — AGENTS.md, PLANS.md, deterministic smoke/test/lint harness commands, strict architecture boundaries, observability from day 1, and entropy-control audits for reliable autonomous agent runs."},"skills_sh_url":"https://skills.sh/broomva/harness-engineering"},"updatedAt":"2026-04-22T19:06:11.488Z"}}