Content
78%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 content is well-structured and actionable, with a clean overview that delegates depth to one real reference file. It is efficient and mostly executable, held back only slightly by a non-copy-paste Bash workaround example and the absence of an explicit post-creation verification loop.
Suggestions
Make the Bash-execution example directly copy-pasteable by working around bug #12762 differently (e.g., placing the ! in a separate code span or noting the substitution more prominently) so users do not have to manually edit the snippet.
Add an explicit verification step to the checklist, such as 'Run /command-name to confirm it executes and the frontmatter/arguments behave as expected', to create a clear post-creation feedback loop.
Trim the redundant restatement of the bug #12762 workaround in the Dynamic Content section since it is already covered by the inline comments and the reference doc.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient — tables and short code blocks deliver the key facts without explaining basic concepts Claude already knows — but includes a few minor padded sections (e.g., the redundant Dynamic Content note restating the bug workaround) that could be trimmed. | 4 / 5 |
Actionability | It provides mostly executable guidance: concrete file locations, frontmatter field tables, and copy-ready code snippets for arguments and file references, but the Bash-execution example requires manual substitution ("Replace EXCLAMATION with the exclamation mark character") rather than being directly copy-paste ready. | 4 / 5 |
Workflow Clarity | A clear checklist and well-sequenced sections (structure → basic command → frontmatter → arguments → dynamic content) guide authoring, and the final checklist acts as a validation checkpoint; however it lacks an explicit test/verify feedback loop for confirming the command works after creation, a minor validation gap. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview with a single, clearly signaled one-level-deep reference to ./references/official-docs.md, which is a real file; content is appropriately split between the overview and the detailed reference, matching the top anchor. | 5 / 5 |
Total | 17 / 20 Passed |