Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and sequenced with strong validation checkpoints for a fragile batch/read-only operation. Its main weaknesses are duplicated schema content between the inline body and the unbundled reference file, and a missed link to that reference.
Suggestions
Replace the inline source-sample.json schema (lines 104–151) with a one-line pointer to references/source-sample-schema.md, e.g. 'See [source-sample-schema.md](references/source-sample-schema.md) for the exact output shape and invariants' — removes the duplication and signals the reference.
Trim justifying prose that isn't instruction (e.g. 'an agent adapts, a script would brittle out') to tighten conciseness without losing the agent-executed rationale.
Add a couple of natural trigger phrasings ('reuse this ad', 'swap the brand on this ad', 'prep an ad for remix') alongside 'remix' to broaden trigger-term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence on content-goose internals, but it inlines the full source-sample.json schema (lines 104–151) that is duplicated verbatim in references/source-sample-schema.md, and includes justifying prose ('an agent adapts, a script would brittle out') — matching the 'mostly efficient but could be tightened' anchor rather than fully lean. | 2 / 3 |
Actionability | Concrete file paths to read, exact JSON shapes, executable commands ('git lfs fetch --include=...', 'git lfs checkout', 'file <path>'), filename→role mapping tables, and explicit matching rules make this instruction-only skill copy-paste-ready despite having no code, matching the fully-actionable anchor. | 3 / 3 |
Workflow Clarity | A clear 4-step sequence (read the run → build JSON → link library → write output) with explicit validation checkpoints (materialize LFS before reading binaries, the per-PNG 'file' variant audit, refuse-to-fabricate guardrails, a summary that surfaces null links and missing/LFS assets) and error-recovery feedback loops in the failure-modes section, matching the explicit-checkpoints anchor. | 3 / 3 |
Progressive Disclosure | Sections are well-organized, but the full output schema is inlined in the body while an equivalent references/source-sample-schema.md exists yet is never linked or signaled from the SKILL — content that should live one level deep is inline, matching the 'references present but not clearly signaled; content that should be separate is inline' anchor. | 2 / 3 |
Total | 10 / 12 Passed |