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 concise, well-structured single-purpose audit skill with concrete comparison criteria, an actionable fix, and clean one-level-deep progressive disclosure to references/rule.md. The main improvement is removing duplication: Check vs Code Review and the intro vs Explain cover the same ground twice.
Suggestions
Merge the 'Check' and 'Code Review' sections — both repeat the same comparison procedure; keep one with the enumerated mismatch types (protocol, www, query string, trailing slash).
Fold the opening paragraph's share-count explanation into 'Explain' to remove the second duplication.
Add a short worked example (a snippet with an og:url/canonical mismatch and the corrected tag) to make the guidance fully copy-paste concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly lean, but contains clear duplication: the 'Check' and 'Code Review' sections both instruct 'Compare the og:url meta tag value with the <link rel='canonical'> href value... Flag any page where they differ', and the intro paragraph overlaps with the 'Explain' section on share counts being split across URL variants. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' — above 2 because there is no padded background instruction, below 4 because the duplicated sections should be merged. | 3 / 5 |
Actionability | Guidance is concrete for an instruction-only skill: exact tags to inspect (<meta property='og:url'>, <link rel='canonical'>), specific mismatch dimensions ('different protocols (http vs https), www vs non-www mismatch, query string differences, trailing slash inconsistencies'), and a specific fix ('Set og:url to exactly the same absolute HTTPS URL as the canonical tag. Remove any UTM parameters, session IDs, or tracking tokens'). Below 5 only because there is no worked example of a mismatching page and its corrected output. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose, read-only audit skill (~30 lines), so the simple-skill exception applies: the single action (compare og:url to canonical, flag differences, then fix) is unambiguous and the Check → Fix sequence is clear. No destructive or risky operation is involved, so no validation cap applies; anchor 5 for simple skills is the best fit. | 5 / 5 |
Progressive Disclosure | The under-50-line body is well organized into Quick Reference / Check / Fix / Explain / Code Review sections, and the single external pointer is clearly signaled at the end ('For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`'). The referenced file exists and contains no further nested references, so references are one level deep and easy to navigate — anchor 5. | 5 / 5 |
Total | 17 / 20 Passed |