Content
93%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 single-file pattern skill: fully executable code in three variants with clear selection criteria, terse opinionated defaults, taste guardrails, and a validation checklist. The only structural weakness is that the application procedure is implied through criteria and checks rather than presented as an explicit sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: defaults are telegraphic ("Width: `1px`; use `2px` only for large hero cards", "subtle beats shiny"), pattern selectors are single-purpose lines ("Use this when the surface has a solid or translucent fill"), and it never explains CSS concepts Claude already knows. Every token earns its place, matching the top anchor. | 5 / 5 |
Actionability | Three complete, copy-paste-ready examples cover the common cases: the border-box/padding-box CSS pattern, the mask-composite pseudo-element pattern for surfaces with complex backgrounds, and a Tailwind arbitrary-property one-liner for one-offs. Each variant ships with explicit selection criteria, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The decision flow is unambiguous (surface fill type selects the pattern; one-offs use the Tailwind shortcut) and the "Quick Checks" section provides concrete validation checkpoints (no double border, radius match, focus accessibility). It falls short of a 5 because the procedure is conveyed through scattered criteria and a checklist rather than an explicit sequenced workflow, and the body exceeds the under-50-line simple-skill exception. | 4 / 5 |
Progressive Disclosure | The skill is a single self-contained file with no bundle directories, and nothing in it warrants extraction: the three short patterns, taste rules, and quick checks are all core content that would be harder to use if split into references. Sections are clearly headed and scoped, which is the appropriate structure for a skill with no need for external references. | 5 / 5 |
Total | 19 / 20 Passed |