Content
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 |