Execute this skill should be used when the user asks about "SPAWN REQUEST format", "agent reports", "agent coordination", "parallel agents", "report format", "agent communication", or needs to understand how agents coordinate within the sprint system. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.
38
36%
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/agent-patterns/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 extremely weak. It fails to explain what the skill actually does (no concrete actions listed), and the 'when' guidance is padded with meaningless boilerplate phrases like 'Use when appropriate context detected' and 'Trigger with relevant phrases based on skill purpose.' While it includes some domain-specific trigger terms, the lack of any substantive capability description makes it nearly useless for skill selection.
Suggestions
Replace the vague description with concrete actions the skill performs, e.g., 'Generates SPAWN REQUEST formatted messages for launching parallel agents, formats agent completion reports, and defines communication protocols between coordinating agents within the sprint system.'
Remove the boilerplate filler phrases ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') and replace with a specific 'Use when...' clause that describes actual scenarios, e.g., 'Use when the user needs to spawn parallel agents, format agent reports, or understand the SPAWN REQUEST protocol.'
Rewrite in proper third-person voice describing capabilities (e.g., 'Defines and formats...' instead of 'Execute this skill should be used when...').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description fails to describe any concrete actions or capabilities. It mentions domain concepts like 'SPAWN REQUEST format' and 'agent coordination' but never explains what the skill actually does. Phrases like 'Use when appropriate context detected' and 'Trigger with relevant phrases based on skill purpose' are pure filler with no substance. | 1 / 3 |
Completeness | The 'what' is essentially missing — there is no explanation of what the skill actually does beyond vague references to understanding coordination. The 'when' clause exists but is padded with meaningless boilerplate ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose') that provides no real guidance. | 1 / 3 |
Trigger Term Quality | It does include some potentially useful trigger terms like 'SPAWN REQUEST format', 'agent reports', 'agent coordination', 'parallel agents', 'report format', and 'agent communication'. However, these are somewhat jargon-heavy and the generic trailing phrases ('relevant phrases based on skill purpose') add no value. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of specific terms like 'SPAWN REQUEST format' and 'sprint system' provides some niche distinctiveness, but the overall vagueness around 'agent coordination' and 'agent communication' could easily overlap with other agent-related skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
50%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 reasonable framework for multi-agent coordination with useful concrete formats (SPAWN REQUEST, AGENT REPORT) and a helpful error handling table. Its main weaknesses are the lack of truly executable commands (the custom DSL blocks aren't tied to actual CLI invocations), missing validation checkpoints in the workflow, and some verbosity in the overview and prerequisites that could be trimmed. The referenced bundle files are absent, making it hard to verify the progressive disclosure structure.
Suggestions
Add explicit validation checkpoints in the workflow, e.g., 'Verify agent received correct spec by checking its initial acknowledgment before proceeding' or a concrete command to validate spawn requests.
Clarify how SPAWN REQUEST blocks are actually executed—is there a CLI command, an API call, or does the orchestrator consume them from a file? Provide the concrete invocation.
Trim the overview paragraph and prerequisites to essentials; Claude doesn't need the conceptual framing of what 'coordination protocol' means.
Ensure referenced files like `ui-test-report.md` exist in the bundle, or note their expected structure inline if the bundle is incomplete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The overview section explains what agent patterns are in a way that's somewhat redundant given the instructions that follow. The prerequisites and some instructional prose could be tightened, but overall it's not egregiously verbose. The error handling table and examples add value without excessive padding. | 2 / 3 |
Actionability | The SPAWN REQUEST format and AGENT REPORT format are concrete and copy-paste ready, which is good. However, these are custom DSL blocks rather than executable code/commands—there's no indication of how to actually execute a spawn (e.g., a CLI command or API call). The instructions are more procedural guidance than executable steps, and some steps like 'partition work by domain boundary' remain abstract. | 2 / 3 |
Workflow Clarity | The steps are sequenced logically (spawn → collect reports → feed back to architect → iterate or advance), and there's mention of iteration limits (5 iterations). However, there are no explicit validation checkpoints between steps—e.g., no step to verify agents received correct files before they start, no validation of report completeness before advancing. The error handling table partially compensates but doesn't constitute inline validation steps. | 2 / 3 |
Progressive Disclosure | The skill references external files like `${CLAUDE_SKILL_DIR}/references/ui-test-report.md` and other skills (sprint-workflow, API contract skill), which is good progressive disclosure. However, no bundle files are provided to verify these references exist, the Resources section mixes concrete file paths with vague references ('Sprint plugin README'), and the main body includes substantial inline content (error table, multiple examples) that could potentially be split out for a cleaner overview. | 2 / 3 |
Total | 8 / 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 | |
16dfbca
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.