Content
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill body is essentially a stub—it contains a one-line description and a single reference to a template file, with no actionable content, workflow steps, examples, or meaningful structure. The description promises a rich multi-step process (session analysis, structured interviews, validated artifact writing) but the body delivers none of it. This needs substantial content to be a functional skill.
Suggestions
Add a concrete multi-step workflow covering the key phases described in the skill description: (1) analyze session context, (2) interview the user with structured prompts, (3) write and validate the skill artifact.
Include at least one concrete example showing input (e.g., a completed workflow scenario) and expected output (e.g., a skeleton SKILL.md with frontmatter and body).
Add validation checkpoints, such as verifying the generated skill against a schema or checklist before finalizing.
Provide a brief quick-start overview in the SKILL.md itself so it's useful without requiring the reader to immediately navigate to the referenced template file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is very brief (only 3 lines of actual instruction), which is lean, but it's so sparse that it's hard to judge efficiency—it essentially delegates everything to a reference file without providing any overview or quick-start content itself. | 2 / 3 |
Actionability | There is no concrete guidance, no steps, no commands, no examples, and no executable content. The entire skill body is a single sentence pointing to a reference file, providing no actionable instruction on its own. | 1 / 3 |
Workflow Clarity | The description mentions a multi-step process (analyzing session context, interviewing the user, writing a validated artifact), but the body contains zero workflow steps, no sequencing, and no validation checkpoints. | 1 / 3 |
Progressive Disclosure | While it references a template file, the SKILL.md itself contains essentially no overview or navigational structure. It's not a well-organized overview pointing to details—it's an empty shell pointing to a single file. Additionally, no bundle files were provided, so the reference cannot be verified. | 1 / 3 |
Total | 5 / 12 Passed |