Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and well-structured with explicit validation checkpoints and clean one-level-deep reference navigation pointing to real bundle files. Its main weakness is length and some repetition of the same rules across multiple sections, which taxes the context window.
Suggestions
Consolidate the layoutSizing/page-setter/font-load rules that recur across Critical Rules, Page Rules, the Pre-Flight Checklist, and the error table into a single canonical statement with cross-links.
Consider moving the long Pre-Flight Checklist into a reference file and summarizing the top checks inline to reduce body length.
Trim repeated rationale sentences where the rule itself already conveys the constraint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly high-signal (rules, executable snippets, tables), but it is very long and occasionally re-explains near-identical rules across the Critical Rules, Page Rules, Pre-Flight Checklist, and error-recovery table, which could be tightened to respect the token budget. | 2 / 3 |
Actionability | It provides fully executable JavaScript snippets (setCurrentPageAsync, createAutoLayout, query/set, return-ID patterns, inspection scripts) and a concrete error-message → fix table, all copy-paste ready with exact API calls and value ranges. | 3 / 3 |
Workflow Clarity | Multi-step work is explicitly sequenced (inspect → skeleton → fill → return IDs → validate → fix) with validation checkpoints, a step-order table mapping each step to get_metadata/get_screenshot checks, and a clear validate→fix→retry feedback loop for atomic failures. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview pointing one level deep to real reference files (gotchas.md, common-patterns.md, api-reference.md, plugin-api-standalone.d.ts, the working-with-design-systems/ set), with a Reference Docs table giving 'when to load / what it covers' navigation; all referenced paths exist in the bundle. | 3 / 3 |
Total | 11 / 12 Passed |