CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autoreview

Auto Review closeout. Runs as parallel review subagents inside the current coding agent (Claude Code or Cursor) — no external reviewer CLI.

Quality

72%

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 ./.agents/skills/autoreview/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 an unusually actionable, well-sequenced orchestration procedure with real measured data and strong validation gates — workflow clarity and actionability are top-tier. Weaknesses are duplicated fast-pass/cost passages that could be consolidated, and a bundle that omits the agents/, OPERATIONS.md, and validator files the orchestrator centrally references.

Suggestions

Consolidate the duplicated fast-pass cost/timing rationale (Effort Levels vs Fast pass section) and the repeated 'wall-clock ≈ slowest subagent' note into a single location, cross-referenced from the other.

Ship the referenced bundle files — the `agents/*.md` specialist prompts, `OPERATIONS.md`, and `validators/line-validator.sh` — or inline minimal versions, since the core dispatch step is unexecutable without them.

Trim rhetorical asides ('like calibrating an instrument', 'A missed bug ships') and the portability narrative where the operational rule alone carries the meaning.

DimensionReasoningScore

Conciseness

The body is dense and expert-level, but the fast-pass cost justification (~30K tokens/~30s vs ~200K/~4min) is stated twice near-verbatim (Effort Levels and Fast pass), "Wall-clock ≈ the slowest subagent, not the sum" appears in both Contract and Running the Review, and there is occasional editorializing ("like calibrating an instrument", "A missed bug ships"). This fits 'mostly efficient but could be tightened'; it is not 4 because the duplication goes beyond minor instances.

3 / 5

Actionability

Guidance is fully executable: copy-paste bash for every target mode (`git diff HEAD`, `gh pr view --json baseRefName --jq .baseRefName`, `git show <commit>`), a regex-based dispatch table, a verbatim subagent appendix template, and a concrete telemetry log-entry format. This matches 'fully executable; copy-paste ready commands' — the common cases (dirty tree, branch/PR, single commit, fast pass) are each covered.

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced (Pick Target → Steps 1–6 → Report → Self-Improvement) with strong validation checkpoints: the mandatory tree-integrity gate with exact verification commands and a 4-step divergence recovery procedure, a capped 3 fix-review cycle with user escalation, deterministic line validation of findings, and a rerun-until-clean stop rule. This matches the top anchor including feedback loops for the risky shared-tree batch operations.

5 / 5

Progressive Disclosure

The design intent is good — a lean orchestrator with clearly signaled, one-level-deep references, each described by purpose — but scored against the actual bundle, the core referenced paths are missing: the `agents/` directory (all 9 dispatchable specialist prompts the workflow depends on), `OPERATIONS.md`, and `validators/line-validator.sh` do not exist; only the four `references/` files resolve. This is more than the 'minor organization gaps' of a 4, but the SKILL.md itself is well structured and the references that do exist are clearly signaled and one level deep, so it is above a 2.

3 / 5

Total

16

/

20

Passed

Description

53%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 distinct and mechanism-clear, but it is a one-sentence positioning statement rather than a capability description. It lacks any 'use when' trigger guidance and omits the natural terms users would say when reaching for the skill.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when the user asks for autoreview, a code review, or a second-pass review before commit/merge/PR.'

List the concrete capabilities in the description: dispatches parallel specialist reviewers (correctness, security, testing, etc.) over a git diff, merges and deduplicates findings, and proposes minimal auto-fix patches.

Include the natural trigger synonyms users actually say — 'code review', 'second-pass review', 'review before shipping/merge' — alongside 'Auto Review'.

DimensionReasoningScore

Specificity

"Runs as parallel review subagents inside the current coding agent" names the domain (code review closeout) and one concrete mechanism, but lists no other capabilities (multi-specialist findings, merge table, auto-fix), matching the '1-2 concrete actions, not comprehensive' anchor. It is not a 4 because several specific actions are not listed; not a 2 because the action described is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (parallel review subagents run inside the current coding agent, no external CLI), but there is no 'Use when...' clause or equivalent trigger guidance; "closeout" only weakly implies timing. Per the guidelines a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Auto Review", "review subagents", "Claude Code", "Cursor"), but the natural phrases a user would actually say — "code review", "second-pass review", "before commit/PR" — are absent. This matches 'some relevant keywords but missing common variations or synonyms', not 4 which requires only a few missing natural terms.

3 / 5

Distinctiveness Conflict Risk

"Auto Review closeout... no external reviewer CLI" carves a distinct niche (in-agent subagent orchestration on named hosts) versus other review skills. It is not 5 because the bare 'review' trigger surface overlaps any generic code-review skill; not 3 because the mechanism and host names make it mostly distinct.

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dwojtaszek/zipper

Path

.agents/skills/autoreview/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.