CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autoreview

Run structured AI code review as an advisory closeout gate for local diffs, PR branches, or commits when the user asks for autoreview, Codex review, second-model review, or pre-ship validation.

Quality

73%

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 ./Skills/agent-ops/autoreview/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 contains genuinely strong operational discipline — explicit validation gates, fail-closed rules, and feedback loops — but it is delivered as a long, redundant policy wall with inconsistent helper paths, unexplained external tool dependencies, and a dangling agents/openai.yaml reference. Consolidating repeated directives and moving the Scope Governor and Release Branch policy into the existing references/ files would substantially improve token efficiency and navigability.

Suggestions

Deduplicate repeated directives: the Codex-default rule, do-not-push rule, never-blindly-apply rule, and heartbeat guidance each appear 2-3 times across Philosophy, Procedure, Constraints, and Gotchas; state each once and cross-reference.

Move the Scope Governor and Release Branches sections into reference files (e.g., references/scope-governor.md) and link them from a short inline summary, keeping SKILL.md as a navigable overview.

Fix path consistency: resolve the <autoreview-helper> placeholder to the bundle's actual scripts/autoreview path, remove or restore the missing agents/openai.yaml reference, and briefly identify external tools (bin/ask, Tessl, gitcrawl) so the validation lane is executable outside the home repo.

DimensionReasoningScore

Conciseness

The ~360-line body is noticeably verbose through internal redundancy rather than explanation of known concepts: "Codex should remain the default" appears three times (lines 21, 335, and the Philosophy section), "do not push" repeats at lines 95 and 103, "Never blindly apply" at lines 70 and 101, heartbeat guidance at lines 83-84 and again in Gotchas line 280, and Anti-Patterns restates Procedure lines nearly verbatim. It is dense operational content, not padding with beginner explanations, so it stays above a 1.

2 / 5

Actionability

Concrete commands with real flags are present (--mode branch --base origin/main, --reviewers codex,claude --thinking codex=high, an ordered validation block), but key details are inconsistent or missing: the helper is invoked as the undefined placeholder <autoreview-helper> in most examples while other examples hardcode Skills/agent-ops/autoreview/scripts/autoreview, which does not match this bundle's actual scripts/autoreview path, and the validation lane depends on unexplained external tooling (./bin/ask, Tessl, gitcrawl). This fits "some concrete guidance but incomplete" better than the "minor gaps" of a 4.

3 / 5

Workflow Clarity

A clear sequence exists (Discovery Interview, Preflight/finding ledger, Pick Target, review run, finding verification, Validation commands in order, Final Report) with explicit validation checkpoints and strong feedback loops ("rerun focused tests ... and rerun the structured review helper", "classify a failure before continuing", fail-closed rules for contradictory output). It falls short of a 5 because the Procedure section is an unsorted ~30-bullet wall mixing policy with sequence, making the actual step order hard to extract.

4 / 5

Progressive Disclosure

References exist and references/discovery-interview.md is linked contextually at the right moment, but agents/openai.yaml is listed in References yet absent from the bundle (a dangling path), contract.yaml/evals.yaml/task-profile.json are only name-dropped at the end rather than signaled from the sections that need them, and roughly 200 lines of Scope Governor, Release Branch, and failure-handling policy are inlined in SKILL.md when they clearly belong in separate reference files.

3 / 5

Total

12

/

20

Passed

Description

83%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, well-formed description: it states what the skill does, its advisory (non-mutating) posture, the three review targets, and four explicit user-facing trigger phrases in one efficient sentence. The only improvements are broader synonym coverage (e.g., plain "code review") and mentioning the findings-triage output.

DimensionReasoningScore

Specificity

The description names the domain ("structured AI code review"), the action ("Run ... as an advisory closeout gate"), and all three concrete target modes ("local diffs, PR branches, or commits"), with minor gaps such as findings triage and verification coverage left unstated. It lists several specific elements but not the multiple concrete capabilities that would justify a 5.

4 / 5

Completeness

It clearly and explicitly answers both what ("Run structured AI code review as an advisory closeout gate for local diffs, PR branches, or commits") and when ("when the user asks for autoreview, Codex review, second-model review, or pre-ship validation") with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Four natural trigger phrases users would actually say are present: "autoreview, Codex review, second-model review, or pre-ship validation". Common variations like plain "code review", "review my diff", or "second opinion" are missing, keeping it below the comprehensive-synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Distinctive trigger terms ("Codex review", "autoreview", "second-model review", "pre-ship validation") carve a clear niche with minimal conflict risk. Generic code-review requests could still overlap with sibling review skills, so it is mostly distinct rather than fully distinct.

4 / 5

Total

17

/

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

jscraik/Agent-Skills

Path

Skills/agent-ops/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.