CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-schema-validator

Designs convex/schema.ts tables, validators, indexes, and relationships, and keeps the schema honest as data evolves. Use when creating tables, adding fields, choosing index fields, modeling relationships, or when a validator error appears at deploy time.

74

Quality

93%

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

90%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 reference-style skill: executable code, hard-to-recall limits and gotchas, and a mistakes table that doubles as error recovery guidance, all without padding. Its only structural trade-off is that the full validator and mistakes reference material is inlined in SKILL.md rather than split into reference files.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious specifics Claude cannot be assumed to know ("At most 8192 items", "Reserved names: by_id and by_creation_time. Limits: 32 indexes per table, 16 fields per index", "Not v.bigint(), which is deprecated") and never pads with explanations of what Convex is. Every section is a compact table or code block where each token earns its place, matching the lean anchor-5 case.

5 / 5

Actionability

Code is complete and executable throughout: a full defineSchema skeleton, a working withIndex query showing equality-prefix-then-range, search/vector index declarations, and return validators including _id/_creationTime. The Common mistakes table pairs each error with a concrete fix, covering the common cases in copy-paste-ready form.

5 / 5

Workflow Clarity

The skill has a clear arc (when to use → skeleton → validators → optional/nullable → unions → indexes → relationships → mistakes → checklist) and validation checkpoints exist ("npx convex dev pushes without a schema validation error", the "v.optional, backfill, then require" migration pattern), so the database-operation cap does not apply. It is not anchor 5 because error recovery is distributed in tables and a checklist rather than an explicit validate→fix→retry loop.

4 / 5

Progressive Disclosure

No bundle reference files exist, and the body is well-organized with clear section headers, a discriminated-unions cross-reference, and a Docs section of external links — good structure with most content appropriately placed. At ~240 lines, the validator reference table and Common mistakes table could plausibly live in separate reference files, which keeps it below the anchor-5 ideal of well-signaled one-level-deep references.

4 / 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 voice, concrete what-statement, and an explicit multi-trigger Use-when clause tightly scoped to the Convex schema domain. The only weakness is slightly thin synonym coverage in the trigger terms.

DimensionReasoningScore

Specificity

"Designs convex/schema.ts tables, validators, indexes, and relationships" lists four concrete, comprehensive actions covering the domain, matching the anchor-5 pattern of multiple specific actions with full coverage. The soft tail "keeps the schema honest as data evolves" is supplementary rather than a gap, so this is not the anchor-4 case of minor coverage gaps.

5 / 5

Completeness

The first sentence explicitly states what the skill does and the "Use when..." clause gives five concrete trigger scenarios, matching the anchor-5 exemplar structure. It is not anchor 4 because the when-clause is fully explicit rather than merely present-but-could-be-more-specific.

5 / 5

Trigger Term Quality

Triggers like "creating tables", "adding fields", "choosing index fields", "modeling relationships", and "a validator error appears at deploy time" are natural phrases users would say, giving good coverage. It falls short of anchor 5 because common variations such as "schema migration", "query", or "database" are absent.

4 / 5

Distinctiveness Conflict Risk

"convex/schema.ts", "validator", and "deploy time" pin the description to the Convex backend niche with distinct triggers and minimal conflict risk with other skills. No broader or generic language creates overlap with unrelated skills.

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

waynesutton/convexskills

Path

skills/convex-schema-validator/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.