Content
77%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 single-rule skill with an unambiguous check/fix workflow and a properly signaled one-level-deep reference. Its main weaknesses are a redundant 'Quick Reference' section that restates the Check/Fix guidance and an opening rationale sentence that explains knowledge Claude already has.
Suggestions
Remove the 'Quick Reference' section — its three bullets duplicate the Check and Fix sections almost word-for-word, saving tokens without losing information.
Delete or shorten the intro rationale sentence ('Frame titles allow users of assistive technology...') since it explains a concept Claude already knows; the 'Explain' section already covers user-facing rationale.
Trim the generic 'Code Review' boilerplate ('roles, labels, focus behavior, or keyboard interactions') to focus on what this rule actually checks: missing, empty, or non-descriptive title attributes on frames.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short but contains trimmable material: the intro rationale ('Frame titles allow users of assistive technology to quickly understand the content of an iframe without having to navigate into it, which is crucial for navigation and orientation') explains a concept Claude already knows, and the 'Quick Reference' bullets ('Add a descriptive `title` attribute to every `<iframe>`') duplicate the Check and Fix sections almost verbatim. | 3 / 5 |
Actionability | Concrete, executable instructions are present: 'Verify that all <iframe> and <frame> elements have a non-empty title attribute' and 'Add a descriptive title attribute to the <iframe> tag'. As an instruction-only skill the absence of inline code is acceptable, but no example of a good vs. bad title or concrete verification command appears in the body itself (they are deferred to references/rule.md), leaving minor gaps. | 4 / 5 |
Workflow Clarity | This is a simple single-task skill and the single action is unambiguous: check that every iframe/frame has a non-empty descriptive title, then add one if missing. The Check → Fix → Explain → Code Review ordering is coherent, the Code Review section points to verification ('note how to verify the fix with browser accessibility tooling or assistive tech'), and the operation is non-destructive so no validation checkpoint is required. | 5 / 5 |
Progressive Disclosure | The body is a lean overview and the single bundle file (references/rule.md, verified to exist) is clearly signaled one level deep: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md.' Content is appropriately split between the quick check/fix in the body and code examples, best practices, and verification in the reference. | 5 / 5 |
Total | 17 / 20 Passed |