CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-patterns

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

Quality

36%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/community/sprint/skills/agent-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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...').

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
Reviewed

Table of Contents

Is this your skill?

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.