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 lean skill body: Grida-specific facts only, executable commands, and a well-structured decision framework with the docsearch script correctly kept one level deep. The only refinements are trimming the meta seed note and stale-prone file counts, and adding slightly more detail on the conflict-escalation step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence (no explaining what ripgrep or frontmatter is), with nearly every line carrying a Grida-specific fact; minor trimmable bits remain — the "Intentional seed" meta blockquote and the stale-prone "~360 markdown files" count — though the "retired May 2026" date is properly confined to the deprecation-style "Dead-tree traps" section. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout ("rg PATTERN -g '!**/docs/_history/**'", "uv run $S find --tag figma --tag wg", "uv run $S show wg/feat-fig/glossary/fig.kiwi.md") plus concrete tie-breaker criteria ("git log -1 recency, what the running entrypoint imports, what tests assert") and doc-trust checks ("draft: true", "doc_tasks:") covering the common cases. | 5 / 5 |
Workflow Clarity | The decision framework is well sequenced — name the surface, pick authority from the per-surface hierarchy, reconcile disagreement with explicit tie-breakers, exclude dead trees, check doc freshness signals — but the final "surface a material conflict to the user" step has no recovery detail, leaving a minor checkpoint gap relative to the level-5 anchor. | 4 / 5 |
Progressive Disclosure | Verified against the actual bundle: the single referenced script (scripts/docsearch.py) exists, is one level deep, and its full usage docs live in the script's own docstring while the body inlines only the essential invocations; sections are clearly organized and the ai-models cross-skill link is well signaled. | 5 / 5 |
Total | 18 / 20 Passed |