Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured meta-skill for prompt improvement that excels in actionability and workflow clarity. Its strongest feature is the disciplined process requiring concrete failure identification before making changes, with clear go/no-go criteria. The main weaknesses are moderate verbosity (the anti-pattern table and inlined best practices could be trimmed) and the inlining of reference content that the skill itself points to an external file for.
Suggestions
Trim the 'Stop If You Catch Yourself' table to 4-5 most critical entries and move the rest to the referenced best-practices file
Reduce the inlined best practices in Step 2 to brief one-liners with a stronger pointer to `references/anthropic-best-practices.md` for details, since the skill already references that file
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content. The 'Core Problem' section explains failure modes Claude could infer, and the 'Stop If You Catch Yourself' table, while useful, is somewhat verbose. The anti-pattern table has 8 entries where 4-5 would suffice. However, the quick reference table and process steps are well-condensed. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: a clear 4-step process, specific before/after examples of what counts as a concrete issue, a quick-reference issue→fix table with exact phrasing changes (e.g., 'Can you…' → imperative 'Do X'), and explicit criteria for when to proceed vs. stop. The guidance is specific enough to be directly applied. | 3 / 3 |
Workflow Clarity | The 4-step process is clearly sequenced with explicit validation checkpoints: Step 1 requires understanding before changing (with go/no-go criteria), Step 2 references documented practices, Step 3 preserves what works, and Step 4 requires rationale for each change. The 'Stop If You Catch Yourself' table serves as an effective feedback loop for error recovery. The process has clear gates preventing premature action. | 3 / 3 |
Progressive Disclosure | The skill references `references/anthropic-best-practices.md` for the full reference, which is good progressive disclosure. However, no bundle files are provided, so this reference is unverifiable. Additionally, the Step 2 section inlines a substantial amount of the best practices content that could arguably live entirely in the referenced file, making the main skill longer than necessary. | 2 / 3 |
Total | 10 / 12 Passed |