Content
100%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.
An exemplary instruction-only skill body: lean prose with no filler, a fully operational workflow from decision framing through a consent-gated paid lookup to a structured deliverable, precise response-schema handling, prompt-injection defense for ad copy, and hard guardrails against fabrication. Bundle references are real, focused, and linked exactly where each is needed in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 37-line body assumes Claude's competence: no space is spent explaining what Meta, CTAs, or ad libraries are, and every line is an operational rule ('Longevity is the signal', 'Group by landing page', 'Separate claim from evidence'). It matches 'every token earns its place' rather than the level below, which reserves room for over-explanation that could be trimmed. | 5 / 5 |
Actionability | Guidance is copy-paste executable: the setup command 'claude mcp add --transport http tracetify https://tracetify.com/api/mcp --header "Authorization: Bearer <key>"' with key source URL, the prefixed tool name 'mcp__tracetify__research_competitor_ads', the 3-credit cost and free re-query window, and field-by-field response schemas (headline, body, cta, linkUrl, start, end, active, libraryUrl; advertiser, format, region, url). Common cases are covered explicitly (connector present/absent, null vs empty arrays, DCO/DPA catalogue ads). | 5 / 5 |
Workflow Clarity | A clear decision-to-deliver sequence with explicit checkpoints and feedback loops: 'wait for an explicit yes' before the paid lookup, with a decline routed to the manual fallback ('If they decline, continue with the manual route below'); the null-vs-empty-array source validation ('Never describe a null source as no ads'); and a required 'what could not be checked' section in the deliverable. Error-recovery paths are stated, matching the top anchor rather than the 'minor validation gaps' level. | 5 / 5 |
Progressive Disclosure | The body stays overview-level and links three focused reference files at the exact point of use: references/angle-extraction.md 'before summarising', references/manual-ad-library.md for the no-connector route, and references/brief-template.md for the output. All three files exist in the bundle, none reference further files, so navigation is one level deep with no orphans — the top anchor. | 5 / 5 |
Total | 20 / 20 Passed |