CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review

Review changed code against project standards. Checks for missing tests, dead code, type safety, lint issues, and coding conventions. Run after completing any implementation work.

Quality

80%

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 ./.claude/skills/code-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.

Extremely actionable and specific — exact commands, paths, and checklists make it a strong operating procedure — but it is a ~48KB monolith with substantial duplication between the standards sections and the review steps, and no progressive disclosure into reference files. Tightening the duplication and splitting the domain rulebooks into references would substantially improve token efficiency.

Suggestions

Split the long domain rulebooks (Bank/Tenant Isolation, HTTP Middleware, Outbound HTTP, Concurrency, Documentation examples) into one-level-deep reference files (e.g. references/bank-isolation.md, references/middleware.md) and keep SKILL.md to the review steps with pointers plus a one-line summary of each rule.

Remove the duplication where review steps 7b/7c/11c/11d/11e/11f/11g restate the full standards text — the steps should reference the rule section by name and keep only the diff-level check and severity verdict.

Fix the step ordering so 11d (concurrency primitives) precedes 11e/11f/11g, or renumber the insertions, so the workflow reads in a coherent sequence.

DimensionReasoningScore

Conciseness

The body is ~550 lines of dense project-specific rules that mostly earn their tokens (bank-isolation invariants, middleware bans, pagination shapes), but it is noticeably duplicated — Bank/Tenant isolation, HTTP middleware, outbound HTTP, concurrency, and docs-example rules are each fully explained in "Code Standards" and then restated in the numbered review steps (7c, 11e, 11f, 11d, 11g). A few sections also over-explain what Claude already knows (the BAD/GOOD raw-dict Pydantic example, generic asyncio lock-binding mechanics), fitting the 3 anchor (mostly efficient, could be tightened) rather than the lean 4–5 anchors.

3 / 5

Actionability

Guidance is fully executable throughout: exact git/grep commands ("git diff main...HEAD | grep -in advisory"), exact file paths and symbol names (BACKUP_TABLES in admin/cli.py, _SINGLE_BANK_TOOLS, LoopLocalSession), a runnable lint script, concrete pagination parameter shapes, and explicit severity labels (must fix / should fix / note). This matches the 5 anchor: copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

A clear 13-step review sequence with a lint checkpoint (step 3), per-step checklists, and a final severity-tiered reporting step. It falls short of the 5 anchor because the step numbering is incoherent — 11d (concurrency) appears after 11e/11f/11g — and validation feedback loops are thin: lint failures are reported but the loop back to re-checking after fixes is only implied, and the review is read-only by design so the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

Section structure is well organized with clear headers, tables, and checklists, but the skill is a 550-line monolith with zero bundle files — no references/, scripts/, or assets/ exist — so large self-contained rule domains (Bank/Tenant Isolation, HTTP Middleware, Outbound HTTP, Concurrency, Documentation examples) that clearly belong in separate one-level-deep reference files are fully inlined. This matches the 3 anchor (good structure, but content that should be separate is inline); it sits above 2 because navigation within the file is easy, and below 4 because no content is split out at all.

3 / 5

Total

15

/

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 description: concrete action list, explicit third-person voice, and a clear "Run after..." trigger clause that answers both what and when. The only gaps are missing common synonyms (PR/diff/pull request) and the mildly generic "project standards" framing.

DimensionReasoningScore

Specificity

The description lists several concrete review actions — "Checks for missing tests, dead code, type safety, lint issues, and coding conventions" — with only minor generic residue ("coding conventions", "project standards"). It does not fully reach the comprehensive 5 anchor because "Review changed code against project standards" is a broad framing rather than an exhaustive action list.

4 / 5

Completeness

Both parts are explicit: the 'what' is "Review changed code against project standards. Checks for missing tests, dead code, type safety, lint issues, and coding conventions" and the 'when' is a concrete trigger clause — "Run after completing any implementation work." This matches the 5 anchor (clear what AND explicit when); the 4 anchor's 'when could be more explicit or specific' does not fit, since the when clause is direct and unambiguous.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: "code", "review", "lint", "tests", "dead code", "type safety". Common variations a user might invoke — "PR", "diff", "pull request", "commit" — are missing, which keeps it just below the 5 anchor's synonym-level coverage; it is clearly above 3 since multiple relevant keywords are covered.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — post-implementation code review against project standards — with distinct triggers. Minor overlap risk exists with generic linting/testing or code-review skills, and the broad "after completing any implementation work" trigger could fire alongside adjacent review skills, so it stops short of the 5 anchor's minimal-conflict bar.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (562 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

vectorize-io/hindsight

Path

.claude/skills/code-review/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.