Content
56%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 terse, well-sectioned contract with a sound fail-fast workflow, but it is almost entirely abstract: no commands, validators, code examples, or framework-specific metadata patterns anywhere in the body. The progressive-disclosure pointer targets a directory absent from the bundle, leaving the actual reference files orphaned.
Suggestions
Name the actual validators in the Validation section (e.g., a specific HTML metadata checker CLI or command) so "run the narrowest real validator" becomes executable guidance.
Add one concrete code example of the dominant framework metadata pattern (e.g., a Next.js metadata export or an OG/Twitter tag block) to anchor the abstract audit/fix steps.
Fix the Progressive Disclosure pointer: either reference the bundle's actual files (references/contract.yaml, evals.yaml, task-profile.json) by name or correct the non-existent Infrastructure/... archive path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — short bullets, no explanations of concepts Claude already knows, no padding (e.g., "Inspect 2-3 focused surfaces before expanding scope"). It falls short of level 5 because Avoid, Gotchas, Anti-Patterns, and Validation overlap repetitively and could be tightened into fewer sections. | 4 / 5 |
Actionability | The guidance is high-level hints with no concrete executable content: "Run the narrowest real validator or command path available" names no actual validator, "Inspect 2-3 focused surfaces" names no surface or command, and no code example (e.g., a Next.js metadata export or an OG-tag snippet) appears. This matches the level-2 anchor (high-level hints missing specific steps) and is below level 3 because there is not even partial concrete command or code guidance. | 2 / 5 |
Workflow Clarity | The five-step workflow is clearly sequenced with explicit fail-fast and re-validation checkpoints ("Stop at the first failed gate or blocker", "Rerun the relevant validation after fixes before claiming completion"). It sits below level 5 because the checkpoints are abstract — no gate is defined by a concrete command or criterion — and above level 3 because validation is explicitly present in the sequence rather than implicit or missing. | 4 / 5 |
Progressive Disclosure | Section organization within SKILL.md is clear, but scored against the actual bundle: the body points to "Infrastructure/references/deferred-skill-context/frontend-ui-fixing-metadata/", a directory that does not exist in this bundle, while the real reference files (references/contract.yaml, evals.yaml, task-profile.json) are never mentioned or navigable. References are neither clearly signaled nor resolvable, fitting the level-3 anchor (structure present but references not clearly signaled). | 3 / 5 |
Total | 13 / 20 Passed |