CtrlK
BlogDocsLog inGet started
Tessl Logo

autoreview

Structured code review when explicitly requested, preferring OpenAI/Codex before Claude.

50

Quality

63%

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

50%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 well-sectioned and grounded in real, executable commands with a genuine bundle behind it, but it behaves as a full operations manual rather than a lean skill overview. Moving the engine-config, image-review, and runtime-boundary policy into reference files would substantially improve both conciseness and progressive disclosure.

Suggestions

Move the engine configuration and auth-projection policy (Codex config.toml routes, catalogue handling, launcher details) into a dedicated reference file, keeping a short defaults table in SKILL.md.

Move the image-review pixel/byte limits and decoder rules into a reference, keeping only the supported-formats summary and the Pillow install note inline.

Consolidate the Git-boundary policy (autocrlf, clean/process conversion, nested checkout rules) into one clearly-labeled reference and trim the inline prose to the decision-relevant rules.

DimensionReasoningScore

Conciseness

The 320-line body is noticeably verbose: long stretches of edge-case policy prose (core.autocrlf handling, clean/process conversion rules, catalogue/auth path resolution, DEVELOPER_DIR and TMPDIR sanitization) sit inline in SKILL.md where a lean overview with pointers would do. It does not tutorialize concepts Claude already knows, which keeps it above anchor 1, but there are several sections that are padding for a top-level skill file, matching anchor 2.

2 / 5

Actionability

Real, copy-paste-ready commands appear throughout ("$AUTOREVIEW" --mode local", the merge-base PR snippet, --source-context examples, the pinned-model invocation), and the mode/target table plus flag list give concrete usage. It is below anchor 5 because large portions are behavioral policy statements rather than executable guidance, but the concrete core is solid, matching anchor 4.

4 / 5

Workflow Clarity

A loose sequence exists (read the diagnostics reference, choose the Git target, pick context/severity options, invoke the helper, follow diagnostics guidance) and the helper's own validation plus --dry-run are described, but the document is organized as a reference manual, not a sequenced workflow — checkpoints are implicit and scattered. This matches anchor 3 (sequence present, checkpoints missing or implicit).

3 / 5

Progressive Disclosure

The single reference (references/diagnostics-and-results.md) is clearly signaled and exists in the bundle, and scripts/autoreview is correctly pointed to. However, the body inlines large topics that clearly belong in separate references (engine configuration and auth projection, image-review limits, runtime boundary policy), leaving SKILL.md itself carrying ~320 lines of detail. This matches anchor 3 (some structure, references present, but content that should be separate is inline).

3 / 5

Total

12

/

20

Passed

Description

58%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, in third person, and states a clear what plus an explicit when, with a distinctive engine-preference hook. Its main weakness is that the when-clause is generic and it carries almost no concrete capability or trigger detail, leaving it under-specified for both discovery and differentiation.

Suggestions

Add one or two concrete capabilities to the description, e.g. "runs Codex or Claude against a local diff, branch, or single commit and returns validated P0-P3 findings".

Replace "when explicitly requested" with concrete trigger phrasing such as "Use when the user or a workflow asks to review a diff, branch, PR, or commit".

Include natural trigger synonyms ("code review", "review my changes", "PR review") to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"Structured code review" names the domain and essentially one action; the engine preference ("preferring OpenAI/Codex before Claude") adds a behavior but no further concrete capabilities (targets, severity, output). This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is above anchor 2 because it is not purely generic, and below anchor 4 because no list of specific actions is given.

3 / 5

Completeness

The "what" is clear (structured code review with a Codex-first engine preference) and the "when" is explicitly stated ("when explicitly requested"), which is more than weakly implied, so it clears the anchor-3 cap. It is not a 5 because "when explicitly requested" names no concrete trigger phrase or scenario — it could describe almost any skill, so the "when" could be far more specific.

4 / 5

Trigger Term Quality

"code review" is a natural term users say, but the description omits common variations such as "review my changes", "PR review", "diff review", or "review this branch". This fits anchor 3 (some relevant keywords, missing common variations); anchor 4 would require broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The Codex-before-Claude preference and the "explicitly requested" gating give it a distinct identity, but "code review" is a broad, crowded trigger space that would overlap with generic review skills and built-in review commands. This is anchor 3 (somewhat specific but could overlap with similar skills); the engine preference keeps it above anchor 2, but the lack of a sharper niche keeps it below anchor 4.

3 / 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
openclaw/acpx
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.