Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a dense, high-signal conventions document: nearly every line records a hard-won, project-specific fact with exact identifiers, SurrealQL syntax, and commands, and it covers destructive-operation safety (append-only guards, parameter binding, cancelable cloud tests) well. The only deductions are time-sensitive version/date details outside a deprecated section and an implicit rather than explicit test-verification checkpoint in the schema-change workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and almost every line is a non-obvious, project-specific fact (the db.close() hang, FLEXIBLE-after-TYPE parse order, no-op updates not firing events) that earns its place. However, time-sensitive details — "The SDK must be 2.2.1 or later", "@surrealdb/node 3.2.0 or later", "This was proven on 9 Nov" — sit outside any deprecated/old-patterns section, which the rubric penalizes, keeping it below anchor 5. | 4 / 5 |
Actionability | Guidance is fully concrete and executable: a copy-paste-ready SurrealQL guard ("DEFINE EVENT OVERWRITE append_only ON <table> WHEN $event IN [\"UPDATE\", \"DELETE\"] THEN { THROW \"...\" }"), exact JS ("new RecordId('project', name)"), named helpers (closeDatabase, recordEvent, safeRecord, memoryDb), exact transaction syntax, and commands like "npm run db:migrate". Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | "Adding a table or field: 1. Change schema.surql. 2. Add a test in test/db/schema.test.ts. 3. Update the data model in PLAN.md" is a clear sequence with validation embedded (a required test step, "A test checks this" for stage parity, idempotent OVERWRITE schema, CANCEL TRANSACTION for cloud tests). It falls short of anchor 5 only because the run-tests-and-verify loop for schema changes is implicit rather than an explicit checkpoint with error recovery. | 4 / 5 |
Progressive Disclosure | This is a lean single-file skill (no bundle files exist) with well-organized sections — Connecting, Schema, Append-only history, Records and values, Queries, Tests — and no inlined bulk content. External pointers ("Read the vendor skills surrealdb-js and surrealql", "described in PLAN.md") are one level deep and clearly signaled, fitting the simple-skill exception for anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |