CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autoreview

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

57

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 ./templates/plate-template/.agents/skills/autoreview/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 exceptionally actionable, with exact commands, flags, and fail-closed policies throughout, and its workflow is coherent with real validation checkpoints. Its weaknesses are length and placement: ~340 lines of dense edge-case policy live in SKILL.md instead of one-level-deep reference files, hurting both token efficiency and navigation.

Suggestions

Move the per-model retry/effort matrices (GPT-6.1 Sol, GPT-6 Sol, Luna, Astra fallback rules) and the Codex provider-projection/authentication detail into a references/engine-configuration.md file, keeping only the default model, --engine/--model/--thinking flags, and one example in SKILL.md.

Relocate rarely-needed operational policy (autocrlf precedence, clean/filter driver handling, macOS temp isolation, catalogue byte-copy rules) into the existing diagnostics-and-results.md or a new references/runtime-details.md, leaving the core run/target/severity workflow in the main body.

Tighten the remaining dense paragraphs into short imperative bullets (e.g., the Git-target and image-review sections) so the core workflow is scannable in a fraction of the current token budget.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and every rule is project-specific, but at ~340 lines (21 KB) it is heavily padded with edge-case policy (autocrlf precedence, catalogue byte-copy semantics, per-model retry matrices) delivered in long dense paragraphs that could be substantially tightened. Accurate verbosity still costs tokens, matching 'mostly efficient but could be tightened' rather than anchor 4's minor trims.

3 / 5

Actionability

Commands are copy-paste ready and complete: the run snippet with $AUTOREVIEW, the PR merge-base recipe using gh and git merge-base, the --source-context and --codex-config examples with exact flags, model names, and environment variables. The mode-selection table maps each target to concrete arguments.

5 / 5

Workflow Clarity

The sequence is coherent (read the diagnostics reference first, run the helper, choose the Git target from the table, select engine and severity threshold, follow diagnostics for results) and checkpoints exist (--dry-run, validated JSON, exit code 2 semantics, fail-closed behavior). It falls short of anchor 5 because the ordering is implied by prose rather than an explicit sequence, and several validation details are deferred to the referenced file.

4 / 5

Progressive Disclosure

Both references (diagnostics-and-results.md, repository-entrypoint.md) are real, clearly signaled, and one level deep. However, large amounts of rarely-needed operational detail — engine retry/fallback matrices, macOS temp isolation, provider catalogue and authentication-path rules, image size limits — are inlined in SKILL.md where a reference file belongs, matching 'content that should be separate is inline.'

3 / 5

Total

15

/

20

Passed

Description

62%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 and grammatically clean, with a clear what and an explicit but generic when-clause. Its main weaknesses are thin capability coverage and missing natural trigger phrases that would help users (and the model) select it over generic review skills.

Suggestions

Enumerate 2-3 concrete capabilities, e.g. 'Runs an independent review of a Git target (local edits, branch, or single commit), filters findings by severity (P0-P3), and emits validated structured results.'

Replace 'when explicitly requested' with concrete triggers, e.g. 'Use when the user or a workflow asks for a code review, a second opinion on a diff, or review of a PR/branch.'

Include natural synonyms such as 'review my code', 'review this diff/PR', and 'independent second opinion' to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Structured code review') and one concrete capability plus the engine preference ('preferring OpenAI/Codex before Claude'), but does not enumerate the skill's actual actions (target selection, severity filtering, structured output). This matches 'names domain and 1-2 concrete actions, but not comprehensive' rather than anchor 4's list of several specific actions.

3 / 5

Completeness

Both parts are present: what ('Structured code review... preferring OpenAI/Codex before Claude') and when ('when explicitly requested'). The when-clause is explicit but generic and could name concrete trigger situations, matching anchor 4 ('when' could be more explicit or specific) rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

'code review' is a natural term users would say, but common variations and synonyms are absent ('review my code', 'review this PR/diff', 'second opinion'), and 'when explicitly requested' is a meta-condition rather than a natural trigger phrase. Some relevant keywords exist, but coverage is incomplete.

3 / 5

Distinctiveness Conflict Risk

The OpenAI/Codex-before-Claude routing gives the skill a clear niche that ordinary code-review skills do not share, leaving only minor overlap risk with closely related review skills. It is not anchor 5 because 'structured code review' alone still overlaps the broad review-skill category.

4 / 5

Total

14

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

udecode/plate

Path

templates/plate-template/.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.