Plan and break down user-story issues into ordered, traceable task issue drafts with explicit publish gates.
45
47%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agents/skills/fusion-issue-task-planning/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description conveys a specific workflow around breaking down user stories into task issues with some domain-specific terminology like 'publish gates' and 'traceable'. However, it lacks an explicit 'Use when...' clause, which is critical for skill selection, and could benefit from more natural trigger terms that users would actually say when requesting this kind of work.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to break down a user story, decompose an epic into tasks, or plan sprint work items.'
Include more natural trigger term variations such as 'subtasks', 'story splitting', 'backlog refinement', 'ticket breakdown', or 'epic decomposition' to improve matching.
Clarify what 'publish gates' means in practical terms so Claude can better distinguish this skill from general issue/task management skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain (user-story issues, task issue drafts) and some actions (plan, break down), and mentions specific concepts like 'ordered, traceable task issue drafts' and 'explicit publish gates'. However, it doesn't list multiple distinct concrete actions—it's essentially one workflow described with qualifiers. | 2 / 3 |
Completeness | The description answers 'what does this do' reasonably well but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent (not even implied clearly), this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like 'user-story', 'issues', 'task', and 'break down', which users might naturally say. However, it misses common variations like 'decompose', 'subtasks', 'story splitting', 'backlog', 'sprint planning', or 'ticket breakdown' that users would likely use. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'user-story issues', 'task issue drafts', and 'publish gates' provides some specificity that distinguishes it from generic project management skills. However, it could still overlap with general issue management or project planning skills without clearer scoping. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
62%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 orchestration skill with a clear multi-step workflow, explicit publish gates, and thoughtful degradation across three runtime modes. Its main weaknesses are the lack of concrete executable examples (no sample tool calls, no example draft output) and some verbosity from repeated delegation instructions across multiple steps. The workflow clarity is strong with validation checkpoints and error recovery paths.
Suggestions
Add a concrete example of a generated task draft (even a minimal one) showing the expected output format with Title, Problem, Scope, AC mapping, etc.
Include an example MCP tool invocation showing the exact parameters passed to fusion-issue-authoring or mcp_github for at least one common operation.
Consolidate the repeated delegation instructions (steps 7, 9, 10 all repeat 'delegate to fusion-issue-authoring, prefer sub-agent') into a single delegation policy section referenced by the steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly detailed and well-structured, but includes some redundancy (e.g., repeated delegation instructions across steps 7, 9, and 10; repeated failure/repair patterns). The three-mode classification system is explained clearly but could be tighter. Some sections like the repair mode and common failures overlap significantly. | 2 / 3 |
Actionability | The skill provides a clear ordered workflow with specific steps, mode classifications, and concrete output expectations. However, it lacks executable code/command examples — no actual MCP tool invocations, no sample draft output, no example of what a generated task plan looks like. The guidance is specific but remains at the procedural description level rather than copy-paste ready. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced with explicit validation checkpoints: devil's-advocate review before drafting (step 6), publish gates requiring same-turn confirmation (step 9), post-flight verification (step 10), and graceful degradation across three modes. Feedback loops are well-defined for error recovery, including repair mode idempotency and partial failure handling. | 3 / 3 |
Progressive Disclosure | The skill references two asset files (follow-up-questions.md, task-plan-template.md) and mentions a .tmp/ output pattern, which is good structure. However, no bundle files were provided to verify these references exist, and the main body is quite long (~150+ lines) with content that could potentially be split out (e.g., the common failures section, the detailed publish delegation rules, repair mode details). | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
060e3af
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.