CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-harness

Use when an agent should drive a goal in one of this repo's domains to a verified close, before starting the work. Compiles the goal into a task plan with goal_compiler.py and runs it through loop_controller.py, which verifies each task, caps retries and escalates.

Quality

94%

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

100%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.

Exemplary skill body: executable commands throughout, an explicit state-machine workflow with controller-enforced verification and retry/escalation feedback loops, and clean progressive disclosure into real reference, script, and asset files. Nothing explained that Claude already knows, and nothing padded.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no concept explanations, just the contract diagram, quick-start commands, hard rules, forcing questions, and exit-code tables. Every section is operational and earns its tokens, matching the 'every token earns its place' anchor rather than merely having 'minor instances of over-explanation'.

5 / 5

Actionability

Fully executable, copy-paste-ready commands with real flags for the full lifecycle: goal_compiler with --goal/--manifest/--out, loop_controller init/next/record/verify/close, and harness_manifest_builder regeneration, plus a concrete example goal. The exit-code table and 'Verifiable success' checks give mechanical branching for the common cases.

5 / 5

Workflow Clarity

The multi-step loop is clearly sequenced as a state machine (GOAL → PLAN → [execute → verify]* → CLOSE) with explicit validation checkpoints — the controller runs checks itself, close is refused (exit 4) while tasks are unverified, evidence is required — and feedback loops for error recovery (retry consumes attempts, exhausted budgets escalate). This is the full anchor-5 pattern.

5 / 5

Progressive Disclosure

The body is a well-organized overview that clearly signals one-level-deep references — verification_discipline.md, agentic_loop_canon.md, and domain_harness_design.md are each linked with a stated purpose — and all referenced paths (3 references, 3 scripts, 20 manifests under assets/harnesses/) actually exist in the bundle. Navigation is easy and content is appropriately split.

5 / 5

Total

20

/

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 with an explicit and specific 'Use when' trigger, a clear third-person statement of what the skill does, and low conflict risk thanks to named scripts and a distinct niche. Keyword coverage is good but misses a few natural synonyms, and a couple of secondary capabilities go unmentioned.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Compiles the goal into a task plan", "verifies each task, caps retries and escalates" — matching the anchor for several specific actions with minor gaps. It stops short of comprehensive coverage: manifest regeneration, state-file resumption, and close/waive semantics are capabilities the skill has but the description omits, so it is not a 5.

4 / 5

Completeness

It explicitly answers both questions: "Use when an agent should drive a goal in one of this repo's domains to a verified close, before starting the work" is a concrete, explicit when-clause, and the compile/verify/cap/escalate pipeline is a clear what. The when is specific rather than merely present, placing it above the 4 anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "drive a goal... to a verified close", "task plan", "verifies each task", "caps retries", "escalates" — phrases a user needing this skill would plausibly say. It falls below the comprehensive anchor because common synonyms and variations like "loop", "autonomous", or "run to done" are absent.

4 / 5

Distinctiveness Conflict Risk

It names its own scripts ("goal_compiler.py", "loop_controller.py") and stakes out a distinct niche — driving goals to verified closure in this repo's domains — so conflict risk with other skills is minimal, matching the clear-niche anchor.

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.