Content
41%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.
The body is a generated redirect stub: maximally token-efficient, but it delegates 100% of the skill's substance to an external file that is not part of the bundle and does not resolve, leaving no actionable guidance, workflow, or verifiable references. As a standalone SKILL.md it fails to deliver the capability its description promises.
Suggestions
Inline the core OCR workflow into SKILL.md — e.g. the pdftoppm-to-image commands, the tesseract invocation, the ocrmypdf fallback, and a verification step that the extracted text is non-empty — instead of delegating to an external path.
Replace the out-of-bundle `~/.agents/skills/ocr/SKILL.md` pointer with reference files that actually ship inside the skill directory (e.g. references/advanced.md) so the pointer resolves wherever the skill is installed.
Add an explicit validation checkpoint after OCR (check output text is non-empty and not garbled, retry with ocrmypdf or different psm settings on failure) to give the multi-step pipeline a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — an HTML comment ("Generated by scripts/agent-harnesses.py; do not edit directly.") and one instruction ("Load and follow the shared skill at `~/.agents/skills/ocr/SKILL.md`.") — with zero padding or explanation of concepts Claude already knows. Every token (aside from the trivial one-line editor comment) serves the delegation, matching the lean-and-efficient anchor; there is no over-explanation to trim, so it does not sit at 4. | 5 / 5 |
Actionability | "Load and follow the shared skill at `~/.agents/skills/ocr/SKILL.md`" is a single concrete directive with a specific path, but it contains no commands, code, or steps for the OCR task itself — the actual guidance (pdftoppm/tesseract/ocrmypdf usage) is entirely absent from this file. This matches minimal-concrete-guidance anchor 2; it is not 1 because the pointer is a real, specific instruction rather than vague abstraction, and not 3 because no partial task guidance exists here. | 2 / 5 |
Workflow Clarity | The described task is a multi-step pipeline (render PDF pages via pdftoppm, run tesseract, fall back to ocrmypdf, verify output), but the body provides no sequence, steps, or validation for any of it — the workflow lives entirely behind an external pointer. This matches anchor 1 ("Steps missing... no sequence; no validation"); the simple-skill exception does not apply because OCR is multi-step, and even the delegation target is a dead end in this bundle. | 1 / 5 |
Progressive Disclosure | The body's only reference is clearly signaled and one level deep, but it points outside the skill bundle to `~/.agents/skills/ocr/SKILL.md`, which does not exist in this environment, and the bundle ships no references/, scripts/, or assets/ files at all — so the skill contains no navigable content, only a broken external pointer. That lands at minimal-structure anchor 2 rather than 3, since the failure is not organization of inline content but a complete absence of reachable material. | 2 / 5 |
Total | 10 / 20 Passed |