Content
75%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.
This is a lean, well-scoped instruction skill: it gives concrete per-section guidance, an explicit title format, a duplicate-check step, and a precise output contract without padding. The main weaknesses are the absence of an ordered step sequence or worked example, and a flat structure with no headings.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is efficient: it does not explain what a feature request is or how GitHub issues work, and each paragraph adds only template-specific guidance (e.g., 'Possible Solution is optional. Include it only if there is a concrete implementation idea'). Minor trimming is possible — the opening scope sentence and the 'Do not create or modify any existing Github issues' sentence partially restate each other — matching the score-4 anchor of 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: the template path is given explicitly, the title format is specified ('feat: add [what] to/in [where]'), output format is pinned ('Provide the markdown code block only'), and per-section guidance is specific (e.g., 'If duplicates or related issues exist, mention them in the Context section'). It falls short of score 5 because there is no worked example of a completed issue and the template contents are external, leaving minor gaps. | 4 / 5 |
Workflow Clarity | As a simple, single-purpose skill the action is largely unambiguous: read the template, fill each section per the guidance, search for duplicate issues and mention them in Context, suggest a title, and output only the markdown code block. It scores 4 rather than 5 because the sequence is scattered across prose (the duplicate-search step appears late, after section guidance) rather than presented as an ordered flow with a final pre-output checklist. | 4 / 5 |
Progressive Disclosure | The single external reference (the feature-request template at ../../ISSUE_TEMPLATE/feature-request.md) is one level deep and clearly signaled, and the body is short enough that no additional files are needed — consistent with the simple-skill guidance. It scores 4 rather than 5 because the flat body has no section headers to aid navigation, and the referenced template path does not resolve from the skill directory as evaluated, so its existence cannot be verified. | 4 / 5 |
Total | 16 / 20 Passed |