Content
78%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 organizational skill body: it defines a crisp inclusion test, gives concrete grep-able markers and a complete naming map, sequences the work with an explicit security-review checkpoint, and keeps external detail one level deep. The residual weaknesses are minor — light rhetorical padding and no verification commands for the stated invariants.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient and competence-assuming — it never explains what a JWT, an OpenAI-compatible endpoint, or a grep is; every section (scoping test, marker, naming map, rules) carries load. A few rhetorical flourishes could be trimmed ("Treat every touch as work on a product that will one day live on its own", "The grep is the index", the closing blockquote), keeping it just below the lean-every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Concrete and executable: a copy-paste grep ("grep -rn 'GRIDA-GG' editor packages desktop"), exact marker comment forms for each surface, a complete identifier table, and a dual-marker example. Minor gaps: the dependency-direction rule ("The gateway must not import desktop/renderer code") states the invariant but gives no verification command, and the working rules reference paths without a check step. | 4 / 5 |
Workflow Clarity | "Working on GG" is a clear 4-step sequence with rationale, and the security crossing has an explicit ordering checkpoint ("runs the `security` review **first** ... then this skill") plus a stated invariant. This is a code-organization skill, not a destructive/batch operation, so the missing validation/verification step (e.g. re-running the grep to confirm tagging) is a minor gap rather than a cap. | 4 / 5 |
Progressive Disclosure | With no bundle files present, all content is appropriately inline in well-labeled sections; every outward reference is one level deep and clearly annotated with its role — canonical spec URL, SECURITY.md boundary, and each companion skill ("the GRIDA-SEC-006 half", "the credit ledger GG spends", "the two hosts"). Navigation is easy with a clean overview-to-detail flow. | 5 / 5 |
Total | 17 / 20 Passed |