CtrlK
BlogDocsLog inGet started
Tessl Logo

code-review

Use when reviewing Basic Machines code for house style, architecture risk, pre-merge hardening, or whether a change fits basic-memory/basic-memory-cloud conventions.

73

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

An excellent instruction-only skill body: concise, concrete, and falsifiable, with an explicit reporting format and severity model. The single gap is workflow sequencing — the review pass order is implied by section order but never stated as explicit steps.

Suggestions

Add a short ordered "Process" list (1. read AGENTS.md/CLAUDE.md and docs/ENGINEERING_STYLE.md, 2. read the diff or named files, 3. apply the rubric and house rules, 4. report in the format) to make the review sequence explicit and lift workflow_clarity to 5.

State explicitly that findings must be verified against the actual code path before reporting (a validate-before-report checkpoint), closing the remaining validation gap in the review workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — every section (Scope, Review Rubric, House Rules, Reporting Format) delivers non-obvious house guidance with no padding and no re-teaching of concepts Claude already knows. It matches anchor 5: every token earns its place.

5 / 5

Actionability

The guidance is concrete and falsifiable: explicit house rules ("No speculative getattr(obj, \"attr\", default)", "Dataclasses for internal value/result objects; Pydantic at validation/serialization boundaries"), a severity table with clear use-for criteria, and a copy-paste-ready reporting template with severity, file:line, Why, and Fix fields. Per the rubric's scoring note, the absence of code in an instruction-only skill is not penalized when guidance is this actionable — matching anchor 5.

5 / 5

Workflow Clarity

Sections follow a sensible review order (scope → rubric → house rules → reporting) and include an explicit no-findings checkpoint ("If there are no findings, say so and note any verification gaps"), but the sequence is implicit — there is no explicit step ordering (e.g., read AGENTS.md/ENGINEERING_STYLE.md first, then the diff, then rules, then report). That places it at anchor 4 (clear sequence, minor gaps) rather than anchor 5's explicit sequenced steps.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed; the body is a compact, well-sectioned overview that clearly signals the external repo docs it depends on (AGENTS.md/CLAUDE.md, docs/ENGINEERING_STYLE.md). Nothing that belongs in a separate file is inlined, and navigation is trivial — matching anchor 5's well-signaled, appropriately split structure.

5 / 5

Total

19

/

20

Passed

Description

87%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: it clearly states what the skill does and when to use it, with concrete trigger phrases and org-specific scoping that sharply limits conflict risk. The only minor gaps are a few missing natural synonyms (e.g., PR/diff review) and reliance on a single action verb.

DimensionReasoningScore

Specificity

The description lists several specific review concerns — "house style", "architecture risk", "pre-merge hardening", and convention fit for named repos — rather than vague language. It falls short of anchor 5 because it names only one action verb ("reviewing") with no broader set of concrete actions, and above anchor 3 because coverage extends well past 1-2 concerns.

4 / 5

Completeness

It explicitly answers both what (reviews Basic Machines code for house style, architecture risk, pre-merge hardening, convention fit) and when ("Use when reviewing Basic Machines code...") with concrete trigger phrasing, matching the anchor-5 example pattern of combined what + explicit when. Not anchor 4, since neither half requires inference or is only weakly stated.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "reviewing Basic Machines code", "house style", "pre-merge" — and the repo names basic-memory/basic-memory-cloud help users targeting those repos. A few common synonyms users might say ("PR review", "diff review", "review my changes") are missing, so it does not reach anchor 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is sharply defined by the organization ("Basic Machines") and two named repositories, so it will not fire for generic code-review requests outside those repos. This gives minimal conflict risk, matching anchor 5's clear-niche description.

5 / 5

Total

18

/

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
basicmachines-co/basic-memory
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.