Content
93%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 well-crafted conventions skill: dense, decisive, and immediately actionable, with clean one-level-deep delegation to sibling skills. The only improvement space is an explicit verification step in the working workflow (e.g., confirming the GRIDA-EE grep set after tagging).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout: every section is an opinionated convention statement ("Don't mint a parallel *-ee suffix", "The cost of moving later is the cost of every import") rather than explanation of concepts Claude already knows. The one framing paragraph ("Grida is open source...") is project-specific context that earns its place, matching the lean anchor rather than the minor over-explanation of a 4. | 5 / 5 |
Actionability | Fully executable guidance for a conventions skill: copy-paste-ready marker comments ("// GRIDA-EE: entitlement — paid-plan gate"), a concrete grep command ("grep -rn 'GRIDA-EE' editor crates packages"), a decisive classification test ("would this feature still make sense in a single-user, no-billing self-hosted instance?"), and unambiguous placement rules. Per the instruction-skill note, absence of runnable code is not penalized since the guidance is concrete and covers the common cases. | 5 / 5 |
Workflow Clarity | "Working on EE features" gives a clear 4-step sequence (tag, place, dependency direction, fail-closed/security cross-check), and the "When EE crosses security" section adds explicit ordering (security review first, then this pattern). It sits below a 5 because there is no explicit verification checkpoint (e.g., re-running the grep to confirm the marker set after tagging, or confirming OSS still builds without the (ee) group); no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: the SKILL.md is a well-organized overview that delegates detail one level deep via clearly signaled sibling-skill links (platform-consumers, naming, security, database, oss-standards) plus a closing "See also" list. Structure and navigation are clean with no nested or buried references. | 5 / 5 |
Total | 19 / 20 Passed |