CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-database

Convex schemas, queries, mutations, actions, auth, migrations and components. Use when designing a Convex schema, writing Convex functions, setting up Convex auth, or migrating Convex data.

70

Quality

88%

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

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

Excellent token-efficient reference material: hard limits, gotchas, and exact API names with zero fluff, plus a deploy sequence with genuine validation checkpoints and a rollback loop. The recurring weakness is a dangling 'checklist' reference for breaking changes and the underspecified widen-migrate-narrow pattern, which keep actionability, workflow clarity, and disclosure just below top marks.

Suggestions

Define or inline the breaking-change migration checklist that the deploy table's 'checklist completed' checkpoint references, or point to where it lives (e.g. '.opencastle/stack/database-config.md').

Expand the widen-migrate-narrow rule with one concrete example (e.g. add the new optional field and deploy, backfill via internalMutation, then remove the old field) so the pattern is executable rather than a label.

Add deployment terms ('deploying a Convex backend', 'npx convex deploy') to the frontmatter description's capability list and trigger clause, since the Deploy Loop is a major section the description currently omits.

DimensionReasoningScore

Conciseness

The body is dense tables and terse bullets with zero padding and no explanation of concepts Claude already knows — every line carries non-obvious, project-specific information ('Documents scanned | 32,000 — includes documents `.filter()` discards'; 'Components cannot access `ctx.auth` or `process.env`'). This matches anchor 5 ('lean and efficient; every token earns its place'); nothing rises to the 'minor instances of over-explanation' of anchor 4.

5 / 5

Actionability

Exact commands and API identifiers appear throughout ('ctx.scheduler.runAfter(0, internal.x.batch, { cursor: result.continueCursor })', 'npx convex env set', 'v.null(), never v.undefined()'), giving mostly executable guidance per anchor 4. It falls short of anchor 5's copy-paste-ready completeness: the deploy checkpoint table says 'checklist completed' for breaking changes but no checklist exists anywhere in the skill, and widen-migrate-narrow is compressed to one line ('widen, migrate, then narrow') without concrete steps.

4 / 5

Workflow Clarity

The Deploy Loop is a clear sequence ('npx convex dev' → verify → 'npx convex deploy') with an explicit error-recovery feedback loop (roll back via 'npx convex import' of the last good export, fix locally, re-deploy) and a five-row checkpoint table, satisfying anchor 4. It misses anchor 5 because the 'Breaking change | checklist completed' checkpoint references a checklist that is never shown, leaving a minor validation gap; the cap-at-3 rule for missing validation does not apply since verification steps are present.

4 / 5

Progressive Disclosure

A single well-sectioned file (Hard limits, Rules by function type, Deploy Loop) with clearly signaled one-level-deep references to the project config ('.opencastle/stack/database-config.md') and official docs, matching anchor 4's 'good structure; most content appropriately placed'. It is not anchor 5: the body exceeds the under-50-lines simple-skill bar, and the migration checklist referenced in the deploy table points to no defined location, a minor navigation gap.

4 / 5

Total

17

/

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: explicit what and when with concrete, product-anchored trigger phrases and near-zero conflict risk. The only meaningful gap is that deployment — covered at length in the body's Deploy Loop section — is absent from both the capability list and the triggers, which costs it on specificity and trigger coverage.

DimensionReasoningScore

Specificity

The 'when' clause lists several concrete actions ('designing a Convex schema, writing Convex functions, setting up Convex auth, or migrating Convex data') and the 'what' enumerates seven capability areas, matching anchor 4's 'several specific actions; minor gaps in coverage' — deployment, a substantial portion of the skill body, is omitted from both what and when. It falls short of anchor 5's 'comprehensive coverage' because of that gap.

4 / 5

Completeness

Both halves are explicit: the 'what' ('Convex schemas, queries, mutations, actions, auth, migrations and components') and the 'when' ('Use when designing a Convex schema, writing Convex functions, setting up Convex auth, or migrating Convex data') with concrete trigger phrases, matching anchor 5 exactly. It is not anchor 4 because the 'when' clause is already fully explicit and specific rather than merely serviceable.

5 / 5

Trigger Term Quality

Natural terms users would say are present and repeated ('Convex schema', 'Convex functions', 'Convex auth', 'migrating Convex data'), giving good keyword coverage per anchor 4. It misses anchor 5's comprehensive coverage: 'deploy' / 'npx convex' — phrases a user asking to deploy their Convex backend would actually say — trigger no match in the description.

4 / 5

Distinctiveness Conflict Risk

'Convex' anchors every capability and every trigger phrase, carving a clear niche (a specific backend platform) with distinct triggers and minimal conflict risk with generic database or ORM skills, matching anchor 5. There is no vagueness that would pull it toward anchors 3 or below.

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

monkilabs/opencastle

Path

src/orchestrator/plugins/convex/skills/convex-database/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.