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.
An exemplary instruction-only skill body: exclusively repo-specific facts, executable commands, concrete authority rules, and built-in staleness validation. Minor room to tighten the duplicated opening framing and to make the grounding sequence an explicit ordered checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and Grida-specific, assumes competence (no explanation of ripgrep, YAML, or search basics), and every section carries non-obvious facts. It is not 5 because the opening paragraph largely restates the frontmatter description and the "Intentional seed" blockquote is meta-commentary that could be trimmed. It is well above 3 — there is no generic padding or explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: "rg PATTERN editor/grida-canvas packages", "rg PATTERN -g '!**/docs/_history/**'", and the docsearch invocations with a concrete script path (verified scripts/docsearch.py exists and supports exactly those subcommands). Concrete file anchors (supabase/migrations/, data/ai/facts.json) and staleness checks (draft: true, doc_tasks:, git log -1) leave no gaps. | 5 / 5 |
Workflow Clarity | The process is discernible and validation checkpoints exist — name the surface, consult the authority table, "Disagreement → decide which wins _and why_ (git log -1 recency, what the running entrypoint imports, what tests assert)", and the draft/doc_tasks/git-log staleness checks before trusting a doc. It is not 5 because this sequence is implicit in section order rather than an explicit ordered workflow or checklist; it is above 3 because concrete checkpoints and decision guidance are present. | 4 / 5 |
Progressive Disclosure | The ~80-line body is self-contained and well-sectioned (source of truth, dead-tree traps, docs grounding, related skills), with a single one-level, clearly-signaled script reference (scripts/docsearch.py, with usage shown inline) that exists in the bundle. There are no nested references and no inlined content that belongs in a separate file, fitting the self-contained-skill pattern. | 5 / 5 |
Total | 18 / 20 Passed |