Content
67%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 well-structured, genuinely actionable instruction skill: a tight five-step workflow with concrete techniques, an explicit Pass/Warn/Fail self-check gate, a keyless runnable probe command, and a clean one-level-deep bundle of reference files. Weaknesses are the long inline measurement-methodology paragraph that duplicates its own referenced protocol file, an implicit rather than explicit fix-and-reverify loop, and a dozen references to parent-repo files that are not shipped in this bundle.
Suggestions
Move the citability-vs-surfacing measurement explanation out of the Data Sources section into references/measurement-protocol.md, keeping only a one-line distinction and the link in SKILL.md.
Make the step-5 feedback loop explicit: after the CORE-EEAT self-check, add 'If any check is Fail: fix the content and re-run the self-check until no Fail is unaddressed'.
Prune or consolidate the parent-repo references (../../../references/*, ../../../scripts/connectors/*, ../../tune/*) that are not part of this skill's bundle, or ship them alongside it, so every link in the body resolves within the distributed skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the five-step workflow is tight and the reference list is one line per item — but the Data Sources section inlines a long measurement-methodology paragraph ('the changes this skill makes... move citability... week-scale and confounded, not minute-level') that duplicates content already living in references/measurement-protocol.md, and the Skill Contract section carries dense handoff/memory boilerplate. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 4 because that inline methodology paragraph is a clear trim candidate, not 2 because there is no padding that explains concepts Claude already knows. | 3 / 5 |
Actionability | The guidance is concrete and executable: numbered steps name specific techniques ('add standalone 25-50 word definitions, sourced quotable statements... Q&A/tables/lists, specific data, and visible-content-matching FAQ schema'), a copy-paste-ready keyless command is given ('python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/tavily.py" search "<target query>" --answer --limit 10'), and a worked input/output example plus a Measured/User-provided/Estimated labeling rule are included. Not 5 because the actual scoring templates and self-check matrix details are deferred to references rather than shown, leaving minor gaps; not 3 because nothing is pseudocode or vague. | 4 / 5 |
Workflow Clarity | A clear five-step sequence ends in an explicit validation step (CORE-EEAT self-check with Pass/Warn/Fail verdicts plus the slop self-check), reinforced by 'Done when' criteria ('each target AI query has a standalone, quotable answer block... no unaddressed Fail'). Not 5 because the error-recovery loop is only implicit — 'no unaddressed Fail' implies iteration but never says 'if Fail: fix and re-verify' as a spelled-out feedback loop; not 3 because validation checkpoints are explicit, not merely listed. | 4 / 5 |
Progressive Disclosure | The six in-bundle references (instructions-detail.md, geo-optimization-techniques.md, ai-citation-patterns.md, quotable-content-examples.md, medium-github-surfaces.md, ai-overview-recovery.md) all exist, are one level deep, and are clearly signaled with one-line descriptions in the Reference Materials section. However, the body also points at roughly ten parent-repo paths absent from this bundle (../../../references/skill-contract.md, ../../../references/measurement-protocol.md, ../../../scripts/connectors/tavily.py, ../../../references/platforms/*.md, ../../tune/content-quality-auditor/SKILL.md), so several linked navigation targets dangle. This fits anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps'); not 5 because of the out-of-bundle dangling references and the inline methodology paragraph that belongs in its referenced file. | 4 / 5 |
Total | 15 / 20 Passed |