SkillsAdd

netresearch/agent-harness-skill · Archived

agent-harness

Use when making a repo agent-ready, verifying harness consistency, checking for documentation drift, bootstrapping harness infrastructure (AGENTS.md as index, docs/ structure, CI verification, enforcement mechanisms), or auditing repo agent-readiness maturity level.

First seen Mar 28, 2026

Installation

$ npx skills add netresearch/agent-harness-skill --skill agent-harness
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

agent-browser Similar · more installs
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
entra-agent-id Similar · more installs
microsoft/azure-skills

Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agen…

288.9K installs
firecrawl-agent Similar · more installs
firecrawl/cli

Autonomous multi-page extraction into structured JSON. Use when the user wants website data mat…

79K installs
agents-sdk Similar · more installs
cloudflare/skills

Build, debug, or review Cloudflare Agents SDK applications using the agents package.

63.9K installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

browser-harness Similar name
browser-use/browser-harness

Control a real browser via CDP: clicking, typing, navigation, logged-in sessions, JS-rendered o…

8 installs
eval-harness Similar name
affaan-m/ecc

Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD)…

9.2K installs
healthcare-eval-harness Similar name
affaan-m/ecc

Patient safety evaluation harness for healthcare application deployments.

7.1K installs
gan-style-harness Similar name
affaan-m/ecc

GAN-inspired Generator-Evaluator agent harness for building high-quality applications autonomou…

7K installs
harness-writing Similar name
trailofbits/skills

Designs and improves fuzzing harnesses for C/C++ and Rust. Covers mapping raw bytes onto a targ…

4.6K installs
harness-creator Similar name
walkinglabs/learn-harness-engineering

>- Build, audit, and improve harnesses that make AI coding agents reliable: AGENTS.md/CLAUDE.md…

2K installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 4
License LICENSE-CC-BY-SA-4.0
Default branch main
Open issues 2
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.8.1
License(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0
CompatibilityRequires Bash, Read, Write, Edit, Glob, Grep tools
Allowed toolsBash(${CLAUDE_SKILL_DIR}/scripts/*) Bash(git:*) Bash(make:*) Read Write Edit Glob Grep Agent
More metadata
author
Netresearch DTT GmbH
version
1.8.1
repository
https://github.com/netresearch/agent-harness-skill

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,206 B
  • docs SUMMARY.md 287 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 28 installs

SKILL.md

Agent Harness

The agent harness makes a repo agent-ready with self-sustaining enforcement. This skill installs it; CI, hooks, and conventions then enforce it.

Modes

1. Verify (primary)

Always start here. From the target repo root, run:

${CLAUDE_SKILL_DIR}/scripts/verify-harness.sh

Analyse the output and fix or suggest fixes. Verification checks dead references, line counts, missing artefacts, and command/target alignment.

2. Bootstrap

When artefacts are missing, create them from templates:

Artefact Template Platform
AGENTS.md templates/AGENTS.md.tmpl All
docs/ARCHITECTURE.md templates/ARCHITECTURE.md.tmpl All
docs/exec-plans/{active,completed}/ Create directories All
.github/workflows/harness-verify.yml templates/harness-verify.yml.tmpl GitHub
.gitlab-ci.yml (harness-verify job) templates/gitlab-ci-harness-verify.yml.tmpl GitLab
.forgejo/workflows/harness-verify.yml templates/forgejo-harness-verify.yml.tmpl Forgejo/Gitea
.github/pullrequesttemplate.md templates/pullrequesttemplate.md.tmpl GitHub
.gitlab/mergerequesttemplates/Default.md templates/mergerequesttemplate.md.tmpl GitLab
.forgejo/pullrequesttemplate.md templates/pullrequesttemplate.md.tmpl Forgejo/Gitea
.envrc templates/envrc.tmpl All
Makefile harness targets templates/Makefile.harness.tmpl All
scripts/verify-harness.sh ${CLAUDESKILLDIR}/scripts/verify-harness.sh (copy directly) All

Populate with repo-specific values; never overwrite existing files without confirmation.

3. Audit

Report the repo's maturity level (1, 2, or 3) and show what is needed to reach the next level. See references/maturity-levels.md for detailed criteria.

Key Principles

  • AGENTS.md is an index, not an encyclopedia. Keep it under 150 lines. Put detail in docs/.
  • Enforcement is project-level. CI workflows, git hooks, and branch protection enforce the harness -- not this skill at runtime.
  • Verify first, bootstrap second. Always run verification before creating artefacts. The skill checks artefacts, not tools.
  • Delegate specialist work. See references/skill-integration-map.md for skill routing (@agent-rules, @github-project, @enterprise-readiness, @retro).
  • Does not own learning. Session retrospection, outcome review, and constitutional audits are delegated to retro-skill. The harness verifies integration points exist (AH-22, AH-23) but does not invoke retro at runtime.

Maturity Levels

Level 1 -- Basic: AGENTS.md exists, is an index, documents commands.

Level 2 -- Verified: CI enforces harness integrity, AGENTS.md references resolve, commands match Makefile/scripts, ARCHITECTURE.md exists.

Level 3 -- Enforced: Branch protection requires harness CI, git hooks auto-activate, PR template includes checklist, drift detection on push.

See references/maturity-levels.md for the full breakdown.

References

  • references/maturity-levels.md -- Maturity criteria and progression
  • references/harness-engineering-overview.md -- Theory: four functions, patterns
  • references/agent-first-architecture.md -- Legibility, layered deps, agent-first tech
  • references/enforcement-mechanisms.md -- 10-mechanism table (CI, hooks, protection, drift)
  • references/skill-integration-map.md -- Skill routing map + integration contracts with companion skills