Content
88%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 procedure-style skill body: lean, densely actionable, and every mode ends in an explicit verification step with diff-review feedback for batch changes. The only real gap is self-containedness — the canonical page shape, save/discard stack, and resource-row contract live entirely in an external rules file, so parts of Modes A and C are not executable from SKILL.md alone.
Suggestions
Inline a minimal skeleton of the canonical SettingsPanel page shape (actions/search/children/modal fragment) and the saveDiscardActions()/useSettingsUnsavedGuard wiring so Mode A is executable without opening the rules file.
Add a short props summary for SettingsResourceRow (trailing vs badge, navigable/clickLabel, bleed) or ship it as a skill reference file so the Mode C conversion has its contract at hand.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a path, a copy-paste grep, a named API, or a decision rule (e.g. "A pixel-size fix swaps only the size class for its exact-pixel token (`text-[12px]` → `text-caption`)") — no explanation of concepts Claude already knows and no padding. Not 4 because nothing can be trimmed without losing operational content; the dense exception lists (exempt shells, non-heading title values) each earn their place. | 5 / 5 |
Actionability | Gives copy-paste-ready commands with exact pathspecs (`git grep -n "flex h-full flex-col bg-\[var(--bg)\]" -- 'apps/sim/**/settings/**' 'apps/sim/ee/'`), named functions (`saveDiscardActions()`, `useSettingsUnsavedGuard`), and expected-match lists to judge output against. Not 5 because key shapes — the canonical page body, the save/discard wiring, and the resource-row contract — are deferred to `.claude/rules/sim-settings-pages.md` rather than shown, so Mode A steps 3–4 and the Mode C conversion aren't executable from this file alone; not 3 because everything actually written here is concrete and executable. | 4 / 5 |
Workflow Clarity | Each mode is a numbered find→fix→verify sequence with explicit validation checkpoints, including for the batch sweep: "Verify the whole sweep: the local gate in the root CLAUDE.md, plus the affected pages' tests. Diff each file against the base and confirm the change is purely structural before shipping." Not 4 because no mode lacks a checkpoint — even Mode C's verify includes a per-block diff read for lost props, conditions, and key placement. | 5 / 5 |
Progressive Disclosure | Clear mode-based sections and a "Key paths" map, with repeated, well-signaled one-level-deep pointers to the convention doc ("The full convention lives in `.claude/rules/sim-settings-pages.md` — read it first; this skill is the procedure"). Not 5 because the skill ships no bundle files and its completeness hinges on external repo rule files that cannot be verified from the bundle itself — a single moved path would silently hollow out Modes A–C; not 3 because structure and reference signaling are clear throughout with no nested-reference chains. | 4 / 5 |
Total | 18 / 20 Passed |