CtrlK
BlogDocsLog inGet started
Tessl Logo

coordinating-multi-space-devops-agent

Coordinate the AWS DevOps Agent across multiple AgentSpaces from one Claude Code session — route questions to the right space (prod vs staging vs knowledge), query several spaces in parallel and synthesize, or compare findings across accounts. Use whenever the user has more than one AgentSpace configured, mentions multiple AWS accounts, or asks something like "check both prod and staging", "compare across accounts", or "ask the knowledge space".

70

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

A strong, well-structured routing skill: concrete tool invocations, a clear decision table, numbered discovery workflow, explicit anti-patterns, and practical timeout guidance. Its main weaknesses are placeholder-laden examples in Patterns A and C, slight redundancy with the frontmatter description, and a "See also" link to a walkthrough file that does not exist in the bundle.

Suggestions

Ship the referenced examples/multi-space-walkthrough.md file (or remove the "See also" link) — the skill's only deeper-dive reference currently points to a non-existent file.

Replace the placeholders in Pattern A ("<question> | env=prod | <prod IaC context>") with one concrete worked example, e.g. an actual error-rate comparison message, so each pattern is copy-paste adaptable.

Trim the intro paragraph ("Many real teams run more than one AgentSpace...") and the "This skill is the routing brain" sentence, which restate the frontmatter description.

DimensionReasoningScore

Conciseness

The body is largely efficient — tables, terse code snippets, and domain-specific context Claude genuinely lacks (per-space scoping, SigV4-vs-Bearer token semantics). Minor trimmable padding exists: "This skill is the routing brain. Use it when the user has multiple spaces configured..." restates the frontmatter description, and the "Many real teams run more than one AgentSpace" paragraph could be tightened. Not a 5 ("every token earns its place") but clearly above the score-3 anchor's "some unnecessary explanation".

4 / 5

Actionability

Concrete tool calls with parameters and example outputs throughout (e.g. the fully worked Pattern B: aws_devops_agent__investigate(title="ECS 503 errors on checkout-service...", agent_space_id="PROD_ID", priority="HIGH")), plus a routing decision table. Falls short of 5 because Patterns A and C use unresolved placeholders ("<question> | env=prod | <prod IaC context>", "<matched_space_id>") rather than one concrete copy-paste-ready example per pattern.

4 / 5

Workflow Clarity

Multi-step processes are well sequenced: numbered discovery steps (list spaces → per-space summary → offer to persist routing guide), a decision table routing question shapes to strategies, and genuine checkpoints (pre-flight tool check, single-space fallback, "ask the user" for ambiguity, 90s timeout skip). Falls short of 5 because there are no explicit verify/recover loops (e.g. what to do when a chat response is empty or an investigate task fails); the 3-cap for missing validation on destructive/batch operations does not apply since investigations and queries are read-oriented and the skill explicitly warns against default fan-out.

4 / 5

Progressive Disclosure

Sections are well organized and appropriately lean for the main body, but the skill's only progressive-disclosure pointer — "examples/multi-space-walkthrough.md for a fully worked scenario" — is a dangling reference: no examples/, references/, scripts/, or assets/ directory exists in the bundle. The signal is clear but the target is missing, so navigation to the deeper material fails; this sits between the score-3 anchor (references present but not reliably usable) and score-4 (references mostly clear with minor gaps), and the broken file pulls it to 3.

3 / 5

Total

15

/

20

Passed

Description

100%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.

An exemplary description: third-person voice, comprehensive concrete capabilities, an explicit "Use whenever" trigger clause with quoted natural user phrases, and a clearly distinct multi-space niche that won't collide with related single-space skills. No penalizable flaws found against any judging guideline.

DimensionReasoningScore

Specificity

"route questions to the right space (prod vs staging vs knowledge), query several spaces in parallel and synthesize, or compare findings across accounts" lists multiple specific concrete actions covering the skill's full scope. Anti-drift check: the score-4 anchor ("several specific actions; minor gaps") is exceeded because coverage is comprehensive for this domain, with no missing capability areas.

5 / 5

Completeness

Both what ("route questions... query several spaces in parallel and synthesize... compare findings across accounts") and when ("Use whenever the user has more than one AgentSpace configured, mentions multiple AWS accounts, or asks something like...") are explicitly stated with concrete trigger phrases. This matches the score-5 anchor example's structure exactly; the score-4 anchor's "'when' could be more explicit" does not fit.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are quoted verbatim: "check both prod and staging", "compare across accounts", "ask the knowledge space", plus "more than one AgentSpace" and "multiple AWS accounts". These are comprehensive synonyms for the multi-space trigger space; the score-4 anchor ("a few natural terms missing") doesn't apply since common variations are explicitly enumerated.

5 / 5

Distinctiveness Conflict Risk

"Coordinate the AWS DevOps Agent across multiple AgentSpaces" carves out a clear niche with triggers ("more than one AgentSpace", "multiple AWS accounts") that are distinct from single-space DevOps Agent skills. Minimal conflict risk; the multi-space condition is an unambiguous discriminator, matching the score-5 anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
aws/agent-toolkit-for-aws
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.