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
88%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly identifies the Convex ecosystem as its domain, lists comprehensive specific capabilities, and includes an explicit 'Use when...' clause with relevant trigger scenarios. The description is well-structured, uses third person voice appropriately, and provides enough detail to distinguish it from other database or backend skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: schema design, real-time queries, mutations, actions, authentication, migrations, performance optimization, and component creation. These are all concrete, identifiable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (reactive database patterns, schema design, queries, mutations, actions, auth, migrations, optimization, components) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Convex', 'schema', 'queries', 'mutations', 'auth', 'migrations', 'performance', 'real-time', 'backend', 'components'. These cover the natural vocabulary a developer working with Convex would use. | 3 / 3 |
Distinctiveness Conflict Risk | The repeated use of 'Convex' as a qualifier throughout both the capabilities and trigger conditions creates a very clear niche. This is unlikely to conflict with generic database skills or other backend framework skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured Convex skill with strong actionability and workflow clarity. The critical development rules section is particularly valuable, providing specific, non-obvious constraints that Claude wouldn't inherently know. The main weaknesses are minor verbosity in some rule explanations and the inability to verify referenced files exist, though the progressive disclosure structure is sound in design.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient and avoids explaining basic concepts, but some sections could be tightened. For example, the explanation that '.filter() is equivalent to JS filtering — neither pushes the filter to storage' is slightly redundant, and the auth example could omit the 'returns' validator note since it's already covered in the rules. The code examples are appropriately sized but the overall document is on the longer side. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code examples for schema definition, queries, mutations, and auth-protected functions. The critical development rules are specific and concrete (e.g., exact import paths, naming conventions for indexes, specific commands like 'npx convex dev'). The workflow includes copy-paste ready bash commands for health checks. | 3 / 3 |
Workflow Clarity | The 'Quick Workflow' section provides a clear 5-step sequence with explicit validation checkpoints, error recovery (rollback via 'npx convex import'), and a dedicated 'Validation Checkpoints' table mapping each step to its verification criteria. The workflow correctly gates deployment behind local validation and includes a feedback loop for failures. | 3 / 3 |
Progressive Disclosure | The topic routing table clearly references five separate reference files for detailed topics, which is good structure. However, no bundle files were provided, so we cannot verify these references exist. The SKILL.md itself includes substantial inline content (code examples, rules) that is appropriate for a main file, but the project-specific config reference to '../../.opencastle/stack/database-config.md' adds a second level of indirection. The balance between inline and referenced content is reasonable but the unverifiable references prevent a top score. | 2 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7a69a05
Table of Contents
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.