CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-harness

Turn any domain folder of skills into a bounded agentic loop: compile a goal into a verifiable task plan, execute tasks with the domain's own tools, verify every task with machine-run checks, retry with caps, escalate to a human when budgets exhaust, and refuse to close until everything is verified or explicitly waived. Use when you want an agent or subagent to pick up a goal and drive it to a verified close across one of this repo's 18 domains ('run this goal through the engineering harness', 'set up an agentic loop for marketing work', 'make the finance domain self-verifying'). NOT for authoring Claude Code Workflow-tool .js scripts (workflow-builder), N-agent tournaments on one task (agenthub), single-file metric optimization (autoresearch-agent), or discovering published loop recipes (loop-library).

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Excellent operational skill body: executable commands with expected exit codes, an explicitly validated loop with retry/escalate semantics, and a clean overview that pushes architecture detail to three real reference files. The only trimmable material is light motivational framing and rationale columns, which barely dilutes an otherwise lean document.

DimensionReasoningScore

Conciseness

The body is dense and high-signal — a compact contract diagram, copy-paste commands, and terse tables — with almost no explanation of concepts Claude already knows. Minor instances could be trimmed: the motivational framing "You are a harness operator, not a hero. The loop — not your optimism — decides when work is done" and the "Why (canon)" column of the forcing-questions table are rationale rather than instruction, fitting the 4 anchor (efficient with minor over-explanation) rather than the every-token-earns-its-place 5.

4 / 5

Actionability

The Quick Start gives fully executable, copy-paste-ready commands with real flags and expected behaviors (goal_compiler with --manifest/--out, loop_controller init/next/record/verify/close), plus a mechanical "Exit codes (branch on these mechanically)" table and a "Verifiable success" section with runnable checks. This matches the 5 anchor: specific commands cover the common cases end-to-end, including failure paths.

5 / 5

Workflow Clarity

The loop is clearly sequenced (pick manifest → compile → init state → next/execute → record → verify → close) with explicit validation at every step: the controller "runs the task's checks ITSELF (subprocess, timeout, evidence log)", close is "refused (exit 4) while any task is unverified and unwaived", and retries require "a changed approach" with caps escalating to a human. This is a batch/automation workflow whose feedback loops and checkpoints are fully present, matching the 5 anchor.

5 / 5

Progressive Disclosure

The body is an overview that keeps inline only the quick start, hard rules, and tables, while signaling one-level-deep references that all exist in the bundle — references/verification_discipline.md, references/agentic_loop_canon.md, and references/domain_harness_design.md ("for the three-layer architecture, the reuse map") — plus scripts/ and assets/harnesses/ used inline by command. Clear split, well-signaled links, easy navigation: the 5 anchor.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: comprehensive concrete actions, explicit use-when triggers with quoted example utterances, and an explicit NOT-for list that sharply delimits it from similarly named sibling skills. The only deductions are a few missing natural trigger variations and second-person voice in the when-clause.

DimensionReasoningScore

Specificity

Quotes like "compile a goal into a verifiable task plan", "verify every task with machine-run checks", "retry with caps, escalate to a human when budgets exhaust", and "refuse to close until everything is verified or explicitly waived" list multiple concrete, comprehensive actions (a clear 5 anchor). However, the trigger clause "Use when you want an agent or subagent to pick up a goal" uses second person, which the judging guidelines penalize by reducing specificity by 1, bringing it to 4.

4 / 5

Completeness

The 'what' is explicit ("compile a goal into a verifiable task plan, execute tasks with the domain's own tools, verify every task with machine-run checks, retry with caps, escalate...") and the 'when' is explicit with concrete trigger phrases ("Use when you want an agent or subagent to pick up a goal and drive it to a verified close across one of this repo's 18 domains"), matching the 5 anchor of answering both with concrete triggers. It is not a 4 because the when-clause includes quoted example utterances rather than a merely generic condition.

5 / 5

Trigger Term Quality

Natural trigger utterances are present verbatim — "'run this goal through the engineering harness', 'set up an agentic loop for marketing work', 'make the finance domain self-verifying'" — plus "agentic loop" and domain names (engineering, marketing, finance). Good coverage, but a few natural phrasings users might say (e.g., "autonomous/agent loop", "drive this task to done automatically", "self-driving workflow") are missing, fitting the 4 anchor rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (goal-to-verified-close loop over domain skill folders) with explicit negative triggers — "NOT for authoring Claude Code Workflow-tool .js scripts (workflow-builder), N-agent tournaments on one task (agenthub), single-file metric optimization (autoresearch-agent), or discovering published loop recipes (loop-library)" — minimizing conflict with closely named sibling skills. This is the 5 anchor; a 4 would leave overlap unaddressed.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

engineering/agent-harness/skills/agent-harness/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.