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.
48
51%
Does it follow best practices?
Impact
—
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
40%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 is heavy on trigger phrases but almost entirely lacks specificity about what the skill actually does. The filler sentences ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') are meaningless padding that add no information. The description needs concrete actions and a clear statement of purpose to be useful for skill selection.
Suggestions
Replace the vague opening with concrete actions the skill performs, e.g., 'Explains the sprint lifecycle phases, describes the convergent-diffusion development model, and guides teams on when and how to use sprints.'
Remove the generic filler sentences ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') as they provide zero selection signal and waste space.
Rewrite in proper third-person voice describing capabilities (e.g., 'Describes sprint phases and iteration workflows') rather than the imperative 'Execute this skill should be used when...'
| 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 'when' is partially addressed through the listed trigger phrases, but the 'what' is essentially missing—there is no clear explanation of what the skill does beyond vague references to a 'sprint execution model' and 'convergent diffusion approach.' The filler sentence 'Use when appropriate context detected' adds no value. | 2 / 3 |
Trigger Term Quality | It includes several natural trigger phrases like 'how sprints work,' 'sprint phases,' 'iteration workflow,' and 'sprint lifecycle,' which users might plausibly say. However, some terms like 'convergent diffusion approach' are jargon, and the trailing 'Trigger with relevant phrases based on skill purpose' is meaningless filler. | 2 / 3 |
Distinctiveness Conflict Risk | The trigger terms around 'sprint phases' and 'convergent diffusion approach' provide some specificity, but the description could easily overlap with general agile/scrum skills or project management skills since it never clearly defines its unique niche or what distinguishes it. | 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 skill provides a well-structured overview of the sprint lifecycle with clear phase sequencing, good error handling coverage, and useful examples. Its main weaknesses are that the instructions read more as documentation of system behavior than actionable guidance for Claude, and the inline content is somewhat verbose given that a detailed phase reference file is already referenced. The workflow clarity is strong with explicit convergence criteria and iteration limits.
Suggestions
Reframe the instructions from descriptive ('The orchestrator locates...') to imperative ('Load the sprint directory...') to make them more actionable for Claude to follow.
Move detailed phase descriptions to the referenced sprint-phases.md and keep only a concise summary table in SKILL.md (phase name, key action, key output) to improve conciseness and progressive disclosure.
| 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 error handling table and examples are well-structured but the instructions section is somewhat verbose for what is essentially a conceptual workflow description. | 2 / 3 |
Actionability | The skill provides concrete commands (/sprint:new, /sprint) and file paths, but the core instructions are descriptive rather than executable—they explain what the system does rather than what the user/Claude should do. The examples section helps but is minimal. There's no executable code beyond slash commands. | 2 / 3 |
Workflow Clarity | The six phases are clearly sequenced with explicit ordering (sequential testing in Phase 3, parallel implementation in Phase 2). The convergence model in step 7 provides a clear feedback loop with a defined escape hatch (5 iterations → manual intervention). The iteration cycle of review → narrow specs → re-execute is well articulated. | 3 / 3 |
Progressive Disclosure | References to external files like sprint-phases.md, agent-patterns skill, and spec-writing skill are present and clearly signaled. However, the bundle has no files provided, so we can't verify the referenced paths exist. The main content is somewhat long and could benefit from moving the detailed phase descriptions to the referenced sprint-phases.md, keeping only a summary in SKILL.md. | 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 | |
69c73e9
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.