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.

48

Quality

36%

Does it follow best practices?

Impact

Pending

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 very weak overall. It lists some domain-specific trigger terms but completely fails to explain what the skill actually does — no concrete actions or capabilities are described. The description is padded with generic filler phrases ('Use when appropriate context detected', 'Trigger with relevant phrases based on skill purpose') that provide zero informational value and suggest auto-generated content.

Suggestions

Replace the generic filler ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.') with a concrete explanation of what the skill does, e.g., 'Defines the SPAWN REQUEST format for launching parallel agents and specifies the report structure agents use to communicate results back to the coordinator.'

Rewrite the 'Use when' clause to be specific and actionable, e.g., 'Use when the user needs to create a SPAWN REQUEST, format an agent report, or understand how parallel agents coordinate within the sprint system.'

Remove the imperative 'Execute this skill' phrasing and rewrite in third person voice describing capabilities, e.g., 'Provides templates and guidelines for agent spawn requests, inter-agent reports, and coordination protocols within the sprint system.'

DimensionReasoningScore

Specificity

The description fails to describe any concrete actions or capabilities. It mentions domain terms 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 does this do' is essentially missing — there is no explanation of what the skill actually performs. The 'when' clause exists but is padded with meaningless filler ('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 specific trigger terms like 'SPAWN REQUEST format', 'agent reports', 'agent coordination', 'parallel agents', 'report format', and 'agent communication'. These are somewhat relevant keywords, though they are domain-specific jargon rather than natural user language, and the trailing generic phrases add no value.

2 / 3

Distinctiveness Conflict Risk

The terms 'SPAWN REQUEST format' and 'sprint system' are fairly niche and unlikely to conflict with many other skills. However, broader terms like 'agent coordination' and 'agent communication' could overlap with other agent-related skills, and the lack of concrete capability description makes it harder to distinguish.

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 examples of SPAWN REQUEST and AGENT REPORT formats. However, it lacks explicit validation checkpoints in the workflow, the actionability is limited by the absence of actual executable commands that process these formats, and the content could be more concise by trimming the overview and some explanatory prose. The progressive disclosure is adequate but unverifiable without bundle files.

Suggestions

Add explicit validation checkpoints to the workflow, e.g., 'Verify agent report contains all required fields before feeding to architect' with a concrete check mechanism.

Clarify what actually processes SPAWN REQUEST blocks—is it a CLI command, a script, or manual orchestration? Provide the exact command or tool invocation.

Trim the Overview section to 1-2 sentences; the current description restates what the instructions already convey.

Provide the referenced `ui-test-report.md` bundle file or note its expected structure inline so the skill is self-contained enough to act on.

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 explanatory prose could be tightened, but overall it's not egregiously verbose. Some sentences like 'It governs how the project architect spawns implementation and testing agents...' describe rather than instruct.

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 what actually processes these blocks (e.g., a CLI command or script). The instructions describe what to do conceptually ('partition work by domain boundary') without always giving executable specifics.

2 / 3

Workflow Clarity

Steps are listed in a logical sequence (spawn → scope → collect reports → parallel partitioning → architect review → testing), but there are no explicit validation checkpoints or feedback loops. Step 5 mentions the architect deciding whether to iterate, but there's no concrete validation step (e.g., 'run X to verify reports are complete'). The error handling table partially compensates but the workflow itself lacks verification gates.

2 / 3

Progressive Disclosure

References to external files like `ui-test-report.md`, sprint workflow skill, and API contract skill are mentioned, but no bundle files are provided to verify they exist. The skill itself is moderately long (~100 lines) and could benefit from moving the error handling table or detailed examples to a reference file. The references section is present but loosely signaled.

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.