CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-reviewer

Convex code reviewer — security, auth, validators, performance, and pattern checks for code in a convex/ directory. Use to review or audit Convex functions before shipping.

Quality

89%

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

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

A tight, well-structured review checklist that assumes Claude's competence and provides concrete, Convex-specific checks with explicit severity mappings and a clear multi-pass workflow. The main weaknesses are minor: duplication between the Workflow and Rules sections costs tokens, and the resource-ownership check plus the report step lack concrete patterns or an example output format.

Suggestions

Merge the Workflow passes and Rules into a single checklist where each check carries its severity inline (e.g., "Flag .filter() on DB queries as Important — it is a full table scan"), removing the duplicated .filter(), Date.now(), validator, and internal.*/api.* entries.

Make the ownership check concrete: specify the expected pattern (e.g., fetch the document with ctx.db.get(id) and compare its userId against the authenticated identity) instead of the generic "verify resource ownership before reads/writes".

Add a brief example of the expected report output — one finding showing severity, why it matters, and suggested fix — so the "Report findings grouped by severity" step has a concrete format to follow.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence (no explanation of what Convex is, drops API names like ctx.auth.getUserIdentity() and withIndex without preamble), and every check is actionable. It is not a 5 because the Workflow passes and the Rules section repeat the same checks — .filter(), Date.now(), validators, and internal.*/api.* each appear twice — where a merged checklist with inline severity ("Flag X as Critical because Y") would be tighter and avoid cross-referencing two sections.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: specific APIs ("ctx.auth.getUserIdentity()", ".filter()", "withIndex", "Date.now()", ".collect()", "internal.* not api.*"), a hard threshold ("<8192 elements"), and explicit severity mappings. It stops short of a 5 because "verify resource ownership before reads/writes" gives no concrete pattern for how to verify ownership, and there is no example of the expected finding/report format despite instructing findings be grouped by severity.

4 / 5

Workflow Clarity

The three passes are clearly sequenced (security, then performance, then code quality) and conclude with an explicit reporting step ("Report findings grouped by severity; explain why each issue matters and suggest a fix"). This is a read-only review skill, so destructive/batch validation caps do not apply, and each pass functions as an explicit checklist for the process.

5 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, and has no bundle files (no references/, scripts/, or assets/ directories exist), so there is nothing that belongs in external files. Sections (Workflow, Rules) are well-organized, matching the rubric's simple-skill exception for scoring 5 with well-organized sections alone.

5 / 5

Total

18

/

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: concrete capability areas, a well-scoped domain, and an explicit trigger clause that answers both what the skill does and when to use it. It is tightly scoped to the Convex niche with minimal conflict risk, though the capability list is at the category level rather than enumerating individual checks, and a few natural trigger synonyms are absent.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "security, auth, validators, performance, and pattern checks" — and scopes them to "code in a convex/ directory", which goes beyond naming the domain. It falls short of a 5 because it enumerates review categories rather than multiple individual concrete actions (compare the anchor-5 PDF example listing extract/fill/merge), and "pattern checks" is the vaguest of the listed items.

4 / 5

Completeness

It explicitly answers both questions: the "what" is "security, auth, validators, performance, and pattern checks for code in a convex/ directory", and the "when" is the explicit trigger clause "Use to review or audit Convex functions before shipping" with concrete trigger phrases. Not a 4 because the 'when' clause is already explicit and specific rather than merely present-but-imprecise.

5 / 5

Trigger Term Quality

Strong natural keyword coverage: "Convex", "code reviewer", "security", "auth", "validators", "performance", "review or audit", and "convex/ directory" — terms a user needing this skill would plausibly say, with the review/audit synonym pair. Not a 5 because it misses additional natural variations a user might say (e.g., "Convex backend", "Convex functions" appears only once, no file-extension mentions like .ts).

4 / 5

Distinctiveness Conflict Risk

"Convex code reviewer" carves out a clear niche with distinct triggers (Convex, convex/ directory, Convex functions), so it is unlikely to fire for unrelated skills. The only conceivable overlap is a generic code-review skill, but the Convex-specific framing keeps conflict risk minimal.

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

openclaw/clawhub

Path

.agents/skills/convex-reviewer/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.