CtrlK
BlogDocsLog inGet started
Tessl Logo

harness-review

HAR: Multi-angle code, plan, scope review. Security/quality check. Trigger: review, code review, plan review, scope analysis. Do NOT load for: implementation, new features, bugfix, setup, release.

65

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./opencode/skills/harness-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-structured, actionable dispatcher with strong progressive disclosure and a clear review workflow including acceptance checklists and re-review feedback. Its main weakness is verbosity in some inline contract and bash-probe sections that could be moved or trimmed.

Suggestions

Move the inline HARNESS_PLUGIN_ROOT bash probe and the multi-line REVIEW_AUTOSTART/REVIEW_TARGET example outputs into a reference file to reduce body length and tighten conciseness.

Consolidate the repeated APPROVE-criteria and TeamAgent-mode restatements that appear in both the body and referenced governance/team-debate sections to avoid duplication.

Inline one or two explicit validation checkpoints in the Minimal Flow (e.g., 'verify spec/Plans alignment before verdict') to lift workflow_clarity from implicit-reference to explicit-checklist form.

DimensionReasoningScore

Conciseness

The body is information-dense contract prose with no padding of basics Claude already knows, but several sections are verbose and could be tightened — the inline HARNESS_PLUGIN_ROOT bash probe, multiple example REVIEW_AUTOSTART/REVIEW_TARGET output strings, and repeated contract restatements — fitting the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than 4.

3 / 5

Actionability

It gives concrete executable commands (e.g., 'bash scripts/harness-review-closeout.sh --dry-run --uncommitted', 'bash scripts/pre-review-cursor.sh'), per-mode reference mappings in tables, and a copy-paste output JSON schema, with only minor gaps (some referenced scripts are external and not bundled), matching the 'mostly executable guidance; concrete code or commands with minor gaps' anchor.

4 / 5

Workflow Clarity

A clear 'Minimal Flow' sequence, an explicit APPROVE acceptance checklist, Review Target Detection with confirmation handshakes, and a REQUEST_CHANGES re-review feedback loop are present; it is not 5 because some validation detail is delegated to references rather than stated inline as explicit checkpoints.

4 / 5

Progressive Disclosure

It is explicitly a thin dispatcher whose body is an overview pointing to one-level-deep references; the mode→reference table signals navigation clearly and all 12 referenced files (code-review, governance, codex-closeout, dual-review, team-debate, security-profile, ui-rubric, plan-review, scope-review, cursor-review, blind-judge, vision-high-res-flow) exist in references/, matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

16

/

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.

The description is concise, third-person, and clearly answers both what the skill does and when to load it, with strong negative-boundary guidance that reduces conflict risk. Its only weakness is slightly limited trigger-term variety and a few uncovered review dimensions.

DimensionReasoningScore

Specificity

Lists several concrete review actions — 'code, plan, scope review' and 'Security/quality check' — with only minor coverage gaps (e.g., no mention of regression/TDD checks that the body performs), matching the 'lists several specific actions; minor gaps' anchor rather than the comprehensive score 5.

4 / 5

Completeness

It clearly states what ('Multi-angle code, plan, scope review. Security/quality check') and when ('Trigger: review, code review, plan review, scope analysis'), and adds explicit negative guidance ('Do NOT load for: implementation, new features, bugfix, setup, release'), matching the 'clearly and explicitly answers both what AND when with concrete trigger phrases' anchor; not below because both halves are explicit with concrete triggers.

5 / 5

Trigger Term Quality

Explicit 'Trigger: review, code review, plan review, scope analysis' covers the natural phrases users would say, but a few common synonyms (e.g., 'PR review', 'audit') are missing, fitting the 'good keyword coverage; a few natural terms missing' anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear review niche with distinct triggers plus an explicit 'Do NOT load for' exclusion list minimizes conflict with adjacent implementation/release skills, matching the 'clear niche with distinct triggers; minimal conflict risk' 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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

15

/

16

Passed

Repository
Chachamaru127/claude-code-harness
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.