CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-collaboration

Standard collaboration patterns for all squad agents — worktree awareness, decisions, cross-agent communication

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/agent-collaboration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, well-organized set of squad collaboration patterns with genuinely concrete artifacts (exact paths, a message template, a fallback command, a rejection checklist). Its weaknesses are the rambling Reviewer Protocol paragraph, whose multi-step sequence is implicit, and scattered meta-commentary that could be trimmed for token efficiency.

Suggestions

Rewrite the Reviewer Protocol as a numbered sequence (reject → coordinator reassigns → independent revision → focused rereview → gate approval) so the workflow order and role boundaries are explicit rather than embedded in one dense paragraph.

Trim meta-commentary: drop the byte-arithmetic rationale and the 'This is Squad coordination, not an ordinary Copilot workflow' sentence; keep only what changes agent behavior.

Give Cross-Agent Communication a concrete convention (e.g., a short request format naming the agent and the question) to match the specificity of the other patterns.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete paths and commands, but several passages could be trimmed: the redundancy arithmetic in Context ('~300 bytes × 18 agents = ~5.4KB of redundant context'), the filler sentence 'This is Squad coordination, not an ordinary Copilot workflow', and a dense, hard-to-parse Reviewer Protocol paragraph. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened', below the 'minor instances' bar of level 4.

3 / 5

Actionability

Concrete, executable guidance dominates: an exact decision-inbox path ('.squad/decisions/inbox/{your-name}-{brief-slug}.md'), a copy-paste message format template, a fallback command ('git rev-parse --show-toplevel'), and a concrete checklist of what a rejection must contain. Minor gaps (Cross-Agent Communication is reduced to 'say so in your response' with no message convention) keep it at 'mostly executable guidance with minor gaps' rather than fully copy-paste-ready level 5.

4 / 5

Workflow Clarity

The simple patterns (worktree awareness, decision recording) are unambiguous single actions, but the Reviewer Protocol presents an implicitly-sequenced multi-step process (reject with evidence → coordinator assigns revision owner → independent correction → focused rereview → gate approval) inside one dense paragraph with no checkpoints or failure handling, fitting 'sequence present but checkpoints missing or implicit'. Not level 4 because a reader must untangle the protocol's order and role boundaries from run-on prose.

3 / 5

Progressive Disclosure

The body is under 50 lines, has no need for external reference files (none exist in the bundle), and is cleanly organized into Context, four labeled ### pattern sections, and an Anti-Patterns section. Per the rubric's simple-skill guidance, this earns the top anchor: a clear overview with well-organized sections and easy navigation.

5 / 5

Total

15

/

20

Passed

Description

50%Weight 40%Scale 1-5

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 identifies a real niche (squad-agent collaboration patterns) and three relevant topic areas, but it reads as a label of subject matter rather than a statement of what the skill does, and it entirely lacks a 'Use when...' trigger clause. It is serviceable but uniformly mid-tier against every anchor.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working as a squad agent on a team, recording a decision that affects other agents, or coordinating across agents in a shared worktree.'

Convert topic nouns into concrete actions: 'Record decisions to the squad decision inbox, locate shared state via TEAM ROOT, request help through the coordinator' instead of 'worktree awareness, decisions, cross-agent communication'.

Add natural synonyms users would say ('team coordination', 'squad workflow', 'agent handoff', 'decision record') to widen trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Standard collaboration patterns for all squad agents') and three concrete topic areas ('worktree awareness, decisions, cross-agent communication'), but describes subject matter rather than actions the skill performs. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' — more than the purely generic level 2, but it never states what the skill actually does with these topics.

3 / 5

Completeness

There is a clear 'what' (standard collaboration patterns for squad agents covering three named areas) but no 'when' clause — the description never says when Claude should load this skill, capping completeness at 3 per the guidelines. Not level 4 because no explicit trigger guidance exists at all; not level 2 because the 'what' is specific and concrete.

3 / 5

Trigger Term Quality

Terms like 'worktree awareness', 'decisions', and 'cross-agent communication' are relevant to the team-workflow domain, but common natural variations are missing (e.g., 'team coordination', 'squad workflow', 'agent handoff', 'record a decision'). This matches the anchor 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

'Squad agents' and 'worktree awareness' give it a distinct multi-agent niche, but 'decisions' and 'cross-agent communication' are generic terms that overlap with any coordination or communication skill, matching 'somewhat specific but could still overlap with similar skills'. Not level 4 because the phrasing describes its audience rather than unique triggers, leaving moderate overlap risk with other teamwork/coordination skills.

3 / 5

Total

12

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

microsoft/waza

Path

.github/skills/agent-collaboration/SKILL.md

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.