Content
86%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 an efficient, well-structured instruction set for a simple single-purpose skill, with mostly concrete guidance and a clear sequence; the only gaps are a missing worked example and an explicit review/retry feedback loop.
Suggestions
Add one short before/after example post to make the voice and structure guidance fully copy-paste concrete.
Clarify what "linkedin_*" refers to (name the specific tool(s) or MCP calls) so step 6 is unambiguous.
Add a brief review/retry checkpoint, e.g. "If the draft does not match the user's past tone, revise against 1-2 of their recent posts before returning."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — six terse directives with zero padding and no explanation of concepts Claude already knows, matching the "every token earns its place" anchor. | 5 / 5 |
Actionability | Guidance is concrete and directive ("never 'I'm excited to share'", "keep paragraphs to 1-2 lines", "publish via linkedin_*"), but it lacks a worked example post and "linkedin_*" leaves the exact tooling unspecified — minor gaps that hold it just below level 5. | 4 / 5 |
Workflow Clarity | A clear six-step numbered sequence ending in a "ready to review" checkpoint, but there is no explicit feedback/retry loop (e.g. what to do when the tone does not match past posts), which the level-5 anchor requires. | 4 / 5 |
Progressive Disclosure | Under 50 lines with a single well-organized purpose and no need for external references — the simple-skill exception applies, so the clean title plus ordered list earns the top score. | 5 / 5 |
Total | 18 / 20 Passed |