Execute this skill should be used when the user asks about "how sprints work", "sprint phases", "iteration workflow", "convergent development", "sprint lifecycle", "when to use sprints", or wants to understand the sprint execution model and its convergent diffusion approach. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.
53
42%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/community/sprint/skills/sprint-workflow/SKILL.mdQuality
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is weak because it fails to explain what the skill actually does—it only lists trigger phrases and vague meta-instructions. The trailing sentences ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') are meaningless filler that add no discriminative value. While some useful trigger terms are present, the lack of concrete capability descriptions makes it difficult for Claude to confidently select this skill.
Suggestions
Replace the opening 'Execute this skill should be used when...' with a clear statement of what the skill does, e.g., 'Explains the sprint execution model, including convergent and diffusion phases, sprint lifecycle stages, and iteration workflows.'
Remove the generic filler sentences 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.' and replace with a specific 'Use when...' clause tied to the actual trigger terms.
Add concrete actions the skill performs, such as 'Describes sprint phases, explains the convergent diffusion approach, and provides guidance on when and how to use sprints in iterative development.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lacks concrete actions. It says 'Execute this skill' and mentions understanding a 'sprint execution model' and 'convergent diffusion approach,' but never describes what the skill actually does—no specific actions like 'explains phases,' 'generates timelines,' or 'creates sprint plans' are listed. | 1 / 3 |
Completeness | The 'what does this do' is essentially missing—there is no clear explanation of what the skill produces or performs. The 'when' is partially addressed with trigger phrases, but the vague trailing sentences ('Use when appropriate context detected') undermine clarity. The absence of a meaningful 'what' caps this at 1. | 1 / 3 |
Trigger Term Quality | It includes several relevant trigger phrases like 'how sprints work,' 'sprint phases,' 'iteration workflow,' 'sprint lifecycle,' which are natural terms a user might say. However, the last two sentences ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') are generic filler that add no value. | 2 / 3 |
Distinctiveness Conflict Risk | The trigger terms around 'sprint phases,' 'convergent diffusion approach,' and 'sprint lifecycle' provide some specificity to a particular sprint methodology, but without describing what the skill actually does, it could overlap with any agile/sprint-related skill. | 2 / 3 |
Total | 6 / 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 reasonably well-structured skill that clearly documents a multi-phase sprint workflow with good sequencing and error handling. Its main weaknesses are verbosity in the phase descriptions (which overlap with the referenced sprint-phases.md) and a descriptive rather than instructive tone that reduces actionability. The progressive disclosure structure is sound in concept but cannot be verified without bundle files.
Suggestions
Tighten the phase descriptions in Instructions to brief summaries (1 line each) since detailed phase reference already exists in sprint-phases.md — avoid duplicating content across files.
Reframe instructions from descriptive ('The orchestrator locates...') to imperative ('Run /sprint to begin Phase 0...') to increase actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some unnecessary elaboration. Phrases like 'Sprint Workflow describes the convergent diffusion execution model used by the Sprint plugin' and detailed descriptions of what each agent does could be tightened. The overview and prerequisites sections add some value but the instructions section is somewhat verbose for what are essentially phase descriptions. | 2 / 3 |
Actionability | The skill provides concrete commands (`/sprint:new`, `/sprint`) and file paths, but it is primarily descriptive rather than instructive. The phases describe what happens rather than what the user should do. The examples section helps but is minimal. There's no executable code beyond simple CLI invocations, and the convergence flow example is illustrative rather than actionable. | 2 / 3 |
Workflow Clarity | The six phases are clearly sequenced with explicit ordering (Phase 0-5), and the convergence model provides a clear feedback loop (iteration reduces noise, completed work removed from specs, failures re-addressed). The 5-iteration pause for manual intervention is an explicit validation checkpoint. The error handling table covers common failure modes with solutions. | 3 / 3 |
Progressive Disclosure | The skill references external files like `sprint-phases.md` for detailed phase information and other skills (agent-patterns, spec-writing, API contract), which is good progressive disclosure. However, no bundle files were provided to verify these references exist, and the main body contains substantial detail about each phase that could potentially be offloaded to the referenced `sprint-phases.md`, making the SKILL.md leaner. | 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 |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
3a2d27d
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.