Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, actionable audit skill: concrete property- and tool-level guidance in the body with full code examples correctly placed one level deep in references/rule.md. The main gaps are minor redundancy in the property lists and an implied rather than explicit validation feedback loop.
Suggestions
State the required properties once (e.g. in Quick Reference) and reference them from Check/Fix to remove the triple repetition.
Make the validation feedback loop explicit, e.g. 'If the Rich Results Test reports errors, fix the flagged properties and re-run until it passes.'
Consider trimming the opening 'why it matters' sentence or moving it to rule.md, since the value of VideoObject rich results is context Claude already has.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the required property list is repeated across Quick Reference, Check, and Fix, and the opening 'why it matters' sentence is mild padding that could be trimmed. | 2 / 3 |
Actionability | Concrete, specific guidance — exact selectors (<video>, YouTube iframes, Vimeo players), the JSON-LD type, named required properties with ISO 8601 format, and a named validation tool — with full code examples appropriately deferred to the reference; for an instruction/audit skill this is actionable without inline code. | 3 / 3 |
Workflow Clarity | A validation checkpoint is present (Google's Rich Results Test in both Check and Fix), but there is no explicit validate→fix→retry feedback loop and the steps are presented as sections rather than a clearly numbered, sequenced workflow with checkpoints. | 2 / 3 |
Progressive Disclosure | The body is a concise overview and signals a single one-level-deep reference (references/rule.md) — verified to exist and to hold the full code examples, property tables, exceptions, and verification steps — so content is appropriately split with easy navigation. | 3 / 3 |
Total | 10 / 12 Passed |