setup

Set up the AWS DevOps Agent and AWS Security Agent connections. Use when the user says "set up", "configure", "connect", or when MCP tools are missing.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

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

An exemplary lean orchestration skill: it gives concrete, executable instructions (named skill invocations in a clear order) with a sensible conditional branch and no padding. Nothing material is missing for a skill of this scope.

Dimension	Reasoning	Score
Conciseness	The six-line body is lean with no padding and no explanation of concepts Claude already knows; every line earns its place, matching the level-3 'lean and efficient' anchor.	3 / 3
Actionability	It names the exact skills to invoke ('setup-devops-agent', 'setup-security-agent') and what each configures, giving concrete, copy-paste-ready guidance for an instruction-only orchestration skill; absence of code is not penalized per the scoring notes.	3 / 3
Workflow Clarity	A clear numbered two-step sequence ('Run these skills in order: 1... 2...') plus an explicit conditional branch ('If the user only needs one agent, run only the relevant skill'); the operation is non-destructive, so no validation checkpoint is required to reach level 3.	3 / 3
Progressive Disclosure	Under 50 lines with no need for external references and no bundle files present; the single organized heading and numbered list satisfy the simple-skill allowance for level 3.	3 / 3
	Total	12 / 12 Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, well-structured description that clearly answers both what it does and when to use it with natural trigger terms. Its main weaknesses are a single high-level action verb rather than multiple concrete actions, and generic trigger verbs that create overlap risk with other setup skills.

Suggestions

Expand the capability statement beyond the single verb 'Set up' to list the concrete actions performed (e.g., 'configure MCP connections, provision agent workspaces, IAM roles, and S3 buckets') to lift specificity toward level 3.

Tie the triggers more tightly to the named agents (e.g., 'Use when the user wants to set up or connect the AWS DevOps or Security Agent, or when those MCP tools are missing') to reduce overlap with generic setup/config skills.

Consider adding a distinguishing noun phrase (e.g., 'AWS agent onboarding') so the skill is unmistakable versus other configuration skills.

Dimension	Reasoning	Score
Specificity	It names the domain and targets ('AWS DevOps Agent and AWS Security Agent connections') with the action 'Set up', but does not enumerate multiple distinct concrete actions, so it falls short of the level-3 'lists multiple specific concrete actions' anchor.	2 / 3
Completeness	It explicitly states both what it does ('Set up the AWS DevOps Agent and AWS Security Agent connections') and when to use it via an explicit 'Use when...' trigger clause, satisfying the level-3 anchor.	3 / 3
Trigger Term Quality	The 'Use when the user says "set up", "configure", "connect", or when MCP tools are missing' clause gives good coverage of natural terms a user would actually say, matching the level-3 anchor.	3 / 3
Distinctiveness Conflict Risk	The named AWS agents give it a niche, but the trigger verbs 'set up', 'configure', and 'connect' are generic and would overlap with other setup/config skills, matching the level-2 'somewhat specific but could still overlap' anchor rather than the clearly-distinct level-3 anchor.	2 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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
Path: plugins/aws-agents-for-devsecops/skills/setup/SKILL.md
Commit: 222ce56

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.