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 lean, well-structured instruction-only skill whose norms are stated as crisp, specific directives without any padding. Its main weakness is actionability: the judgment rules hinge on undefined terms ('fake UX', 'generic enterprise UI drift') and provide no examples of what applying or violating a norm looks like in practice.
Suggestions
Add one-line definitions or a canonical example for each judgment term — e.g., what qualifies as 'fake UX and fake controls' or 'generic enterprise UI/architecture drift' — so the rules can be applied consistently.
Add a short 'when rules conflict' or 'during review' checkpoint (e.g., 'when reviewing, check changes against each Cultural Rule before approving') to turn the norms into an executable sequence.
Optionally show one worked example (a change that follows the norms vs. one that violates them) to make the abstract rules concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~26 lines of terse, dense directives with zero padding and no explanation of concepts Claude already knows. Every rule ("If a rule is organizational, enforce it on the server") carries information, matching 'Lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | Rules like "If a pattern repeats, capture it as a skill or project convention" and "If a rule is organizational, enforce it on the server" are concrete behavioral directives, but key terms are undefined — 'fake UX and fake controls', 'generic enterprise UI/architecture drift', and what a 'substantial' change is are left to guesswork, and there are no examples of rule violations or correct application. This is 'some concrete guidance but incomplete; missing key details' rather than the mostly-executable level of 4. | 3 / 5 |
Workflow Clarity | The 'When to Use' section gives explicit use conditions and the rules are a simple flat checklist with no risky multi-step process, so the simple-skill pattern applies; the single action (apply these norms during the listed activities) is unambiguous. It does not reach 5 because there is no guidance on what to do when rules conflict or when a review finds a violation — a light decision/checkpoint step would complete it. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external references needed, and the content is cleanly split into three well-organized sections (When to Use, Cultural Rules, Collaboration Rules) with no inline content that belongs in a separate file. Per the rubric's simple-skill guideline, this warrants 5 on well-organized sections alone. | 5 / 5 |
Total | 17 / 20 Passed |