Content
71%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 concise, actionable, and clearly scoped as a non-destructive single-task skill, scoring well on conciseness, actionability, and workflow clarity. Its main gap is structural: the body lacks section headers that would aid navigation, and the referenced template file does not exist in the bundle.
Suggestions
Add section headers (e.g. ## Template, ## Field guidance, ## Output) so the flat instruction list is easier to scan and navigate.
Verify the referenced template path ../../ISSUE_TEMPLATE/feature-request.md resolves from the skill location, or bundle the template inside the skill so the reference is real.
Reorder the steps into an explicit numbered sequence (locate template -> search for duplicates -> fill fields -> suggest title -> emit markdown block only) to make the workflow sequence unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence with no concept padding; the only redundancy is between the first two paragraphs ("only applies to..." and "only for generating..."), keeping it just below anchor 5. | 4 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill — explicit template path, the title format `feat: add [what] to/in [where]`, per-section field instructions, and a search-existing-issues step — but lacks a worked example of a completed request, fitting anchor 4. | 4 / 5 |
Workflow Clarity | The skill is single-task and explicitly non-destructive ("Do not create or modify any existing Github issues"), so no validation cap applies; requirements are clear but not numbered and the search step is ordered after the section guidance, fitting anchor 4. | 4 / 5 |
Progressive Disclosure | There is one clearly signaled one-level reference (the template markdown link) but no header/section structure — the body is a flat paragraph list — so it sits below the well-organized-with-headers bar of anchor 4. | 3 / 5 |
Total | 15 / 20 Passed |