Content
73%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.
A strong, unusually concrete capability spec: it captures a verified setup pitfall, exact identity and assertion patterns, and an explicit validate-then-report loop with error-recovery discipline. Its weaknesses are redundancy (intro rhetoric plus Rules that restate the Workflow) and references to files/capabilities that are not part of this bundle.
Suggestions
Cut the intro paragraph to a single sentence and delete Rules bullets that restate Workflow steps 2–5 (identity driving, seeding a second user, edge-runtime config, never weakening assertions) so each rule states only new information.
Replace the prose description of the vitest config with a complete minimal `vitest.config.ts` code block so step 2 is copy-paste ready.
Either bundle or inline the shape of the finding to emit — the reference to `specs/finding.schema.json` is not resolvable from this skill's files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, verified specifics, but the opening paragraph is rhetorical framing ("A green typecheck proves the code parses... the loop the whole field is missing") that re-motivates what the Rules already state, and Rules bullets 1–3 and 5–6 substantially restate Workflow steps 3–7 (seed both users' rows, drive multiple identities, never weaken an assertion, vitest config required). It could be tightened by roughly a third without losing any instruction. | 3 / 5 |
Actionability | Mostly executable guidance with concrete inline snippets: `test.environment: "edge-runtime"` with `server.deps.inline: ["convex-test"]`, `t.withIdentity({ subject, tokenIdentifier, ... })`, `expect(...).rejects.toThrow(/forbidden|not authorized|403/)`, `t.run(async (ctx) => ctx.db.insert(...))`, and `npx vitest run`. Minor gaps: the vitest.config.ts is described in prose rather than shown as a complete file, and snippets use ellipses/placeholders rather than being copy-paste ready. | 4 / 5 |
Workflow Clarity | The 7-step sequence (IDENTIFY → SET UP → SEED → DRIVE → ASSERT → RUN → handoff) is clearly ordered with an explicit validation step ("RUN the tests (`npx vitest run`) and report: what was proven... and — critically — any assertion that FAILED") and a genuine error-recovery feedback path (step 7: a failing negative test is a real defect — do not weaken the assertion, hand the fix to convex-authz, emit a bus finding). The `import.meta.glob is not a function` failure mode is pre-documented so setup errors are recoverable. | 5 / 5 |
Progressive Disclosure | The body is well organized into Workflow and Rules sections and, at ~35 lines for a single-purpose skill, needs no external files — but it points to artifacts outside any bundle: "specs/finding.schema.json", the `test` and `convex-authz` capabilities, and a generated-from path in the HTML comment. None of these exist in the skill's directory, so the references cannot actually be navigated. | 4 / 5 |
Total | 16 / 20 Passed |