CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-database

Convex reactive database patterns, schema design, real-time queries, mutations, actions, authentication, migrations, performance optimization, and component creation. Use when designing Convex schemas, writing queries/mutations, managing the Convex backend, setting up auth, migrating data, optimizing performance, or building Convex components.

72

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

86%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 dense, high-signal reference: limits, gotchas, and deploy workflow are all concrete and current, with no filler. The main improvement opportunities are a complete executable example for the self-scheduling batch pattern and slightly more specific deploy verification checkpoints.

Suggestions

Provide a complete, copy-paste-ready code example of the cursor-based self-scheduling internalMutation batching pattern instead of the inline prose sketch (actionability).

Make the deploy 'verify' step and the 'Smoke check passes' / 'checklist completed' checkpoints concrete — name the exact commands or checks to run before deploy (workflow_clarity).

Briefly state what the breaking-change checklist contains or where it lives, so the 'Breaking change | checklist completed' checkpoint is actionable (workflow_clarity).

DimensionReasoningScore

Conciseness

Lean and efficient throughout: dense limit tables and rule statements like 'Do not use .filter()... neither pushes the predicate to storage' and 'Skip no-op writes: compare before ctx.db.patch()'. It assumes Claude's competence, explains nothing generic, and every token earns its place — matches the 5 anchor; not 4 because there are no sections that could be trimmed.

5 / 5

Actionability

Mostly executable guidance: concrete commands ('npx convex dev', 'npx convex deploy', 'npx convex import', 'npx convex insights', 'npx convex codegen') and exact API identifiers (v.null(), .withIndex(), internalMutation). However, the key batching pattern ('paginate({ cursor, numItems }) ... ctx.scheduler.runAfter') is sketched inline in prose rather than as a complete, copy-paste-ready example — a minor gap fitting the 4 anchor; not 5 because the most important pattern is not fully executable as written, and not 3 because the guidance is concrete, not pseudocode.

4 / 5

Workflow Clarity

The Deploy Loop gives a clear sequence (dev → verify → deploy) with a checkpoint table and an explicit rollback path, and the batching rule addresses batch-operation safety. Minor gaps remain: 'verify' and checkpoints like 'checklist completed' / 'Smoke check passes' are not fully specified, and the destructive batch/migration flows rely on implicit validation — fits the 4 anchor; not 5 because checkpoints are named but not all are actionable validation steps, and not 3 because a real sequence with explicit checkpoints is present.

4 / 5

Progressive Disclosure

Compact (~75 lines), well-organized sections, and external material is clearly signaled one level deep (the project-specific '.opencastle/stack/database-config.md' and https://docs.convex.dev/). No bundle files exist to split further, and the body is appropriately sized for the main file — matches the 5 anchor under the simple-skill guidance.

5 / 5

Total

18

/

20

Passed

Description

92%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: third person, concrete capability list, and an explicit 'Use when...' clause with specific triggers. Keyword coverage is good but could add a few more natural synonyms users say when working with Convex.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'schema design, real-time queries, mutations, actions, authentication, migrations, performance optimization, and component creation' — with comprehensive coverage of the domain, matching the top anchor; not 4 because there are no notable gaps in the action list.

5 / 5

Completeness

Both parts are explicit: a clear 'what' (first sentence enumerating capabilities) and a concrete 'when' ('Use when designing Convex schemas, writing queries/mutations, ... or building Convex components'), matching the 5 anchor exactly; not 4 because the 'when' clause is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('Convex schemas', 'writing queries/mutations', 'managing the Convex backend', 'setting up auth', 'migrating data', 'optimizing performance'), but a few natural phrasings users might say (e.g., 'real-time data', 'Convex functions', config file work) are missing — the 4 anchor 'good keyword coverage; a few natural terms missing' is the best fit.

4 / 5

Distinctiveness Conflict Risk

'Convex' names a clear niche with distinct triggers, so it is unlikely to fire for other database/backend skills — minimal conflict risk per the 5 anchor.

5 / 5

Total

19

/

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
monkilabs/opencastle
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.