CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-performance-audit

Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.

67

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 ./.agents/skills/convex-performance-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, actionable audit skill with clear navigation to four real reference files and explicit validation checkpoints. The only meaningful weakness is mild repetition of the sibling-function guidance.

Suggestions

Consolidate the sibling-function guidance: state the rule once (in step 4) and reference it from step 3 and the checklist rather than restating it three times.

DimensionReasoningScore

Conciseness

The body is substantive and free of basic-concept padding, but the sibling-function guidance is restated across step 3, step 4, and the verify checklist, so it could be tightened. Not a 3 because some repetition remains.

2 / 3

Actionability

It gives concrete commands ('npx convex insights --details', 'npx -y convex@latest insights --details'), specific APIs to trace (ctx.db.get/query/patch/replace/insert, useQuery/usePaginatedQuery/useMutation), a symptom-to-reference routing table, and a copy-ready verification checklist.

3 / 3

Workflow Clarity

A clearly sequenced 5-step workflow ends with an explicit 'Verify before finishing' checklist, and 'Escalate Larger Fixes' adds a stop-and-confirm checkpoint before invasive changes, covering the feedback loop for risky operations.

3 / 3

Progressive Disclosure

SKILL.md is a concise overview with a signal-routing table and a Reference Files section pointing one level deep to four real, verified reference files (hot-path-rules, occ-conflicts, subscription-cost, function-budget), each with a one-line description.

3 / 3

Total

11

/

12

Passed

Description

75%

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 that clearly states both what it does and when to use it within a well-scoped Convex niche. The main weakness is trigger-term naturalness and action-verb breadth.

Suggestions

Add a second concrete verb (e.g., 'Diagnoses and fixes') so the action list reads as multiple specific actions rather than one verb applied to several targets.

Soften jargon triggers by pairing technical terms with everyday phrasings users actually say (e.g., 'slow Convex pages or features' alongside 'read amplification').

DimensionReasoningScore

Specificity

It names the domain (Convex performance) and several concrete audit targets ('reads, subscriptions, write contention, and function limits') but relies on a single verb ('Audits') rather than listing multiple distinct actions like the 3-anchor examples do.

2 / 3

Completeness

Both halves are explicit: what ('Audits Convex performance for reads, subscriptions, write contention, and function limits') and when ('Use for slow features, insights findings, OCC conflicts, or read amplification').

3 / 3

Trigger Term Quality

It offers relevant triggers ('slow features', 'OCC conflicts') but mixes in jargon-heavy terms ('insights findings', 'read amplification') that less technical users may not naturally say, missing common phrasings.

2 / 3

Distinctiveness Conflict Risk

The Convex-performance niche with its specific triggers (OCC conflicts, read amplification, subscription cost) is clearly distinct and unlikely to fire for unrelated skills.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openclaw/clawhub
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.