CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

Quality

89%

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

100%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 an exemplary minimal dispatch skill: fully lean, unambiguous, and actionable, delegating detail to two named sibling skills with an explicit ordering and a sensible conditional. There is nothing to tighten or restructure at this scope.

DimensionReasoningScore

Conciseness

The body is eight lean lines with no padding and no explanation of concepts Claude already knows; every sentence either names a step, its scope, or the conditional. It matches anchor 5 (lean and efficient, every token earns its place) and is not 4 because there is nothing that could be trimmed.

5 / 5

Actionability

It gives fully executable instructions — invoke the named `setup-devops-agent` and `setup-security-agent` skills, with each step's scope spelled out ("agent space, IAM role, S3 bucket") and the common variation handled ("If the user only needs one agent, run only the relevant skill"). Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this concrete, so it fits anchor 5 rather than 4, which implies minor gaps.

5 / 5

Workflow Clarity

The two steps are explicitly sequenced ("Run these skills in order") with a clear conditional for the single-agent case, and the operation is neither destructive nor batch, so no validation cap applies. This matches anchor 5 under the simple-skill exception for unambiguous single-purpose content, not 4, since nothing in the sequence is ambiguous or missing.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files needed, and its two references to sibling skills are one level deep and clearly signaled as numbered steps. Per the rubric guideline for short self-contained skills, this fits anchor 5 (well-organized, easy to navigate), not 4, which reserves room for organization gaps that are absent here.

5 / 5

Total

20

/

20

Passed

Description

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

A strong description that clearly states its purpose and includes an explicit, well-phrased "Use when" clause with natural trigger terms. The main weakness is thin capability coverage: the description names the two agents but not what setup entails, and its generic action verbs give it some overlap risk with other configuration skills.

Suggestions

Enumerate the concrete setup actions in the description (e.g., configuring the MCP connection, creating the agent workspace, IAM role, and S3 bucket) to raise specificity from a single generic action to several concrete ones.

Add distinguishing trigger terms such as "AWS agent", "DevOps agent", or "Security agent" so the description is less likely to collide with unrelated setup or configuration skills.

Mention the AWS-specific scope (e.g., "AWS DevOps Agent and AWS Security Agent in the AWS environment") to sharpen the niche and improve distinctiveness.

DimensionReasoningScore

Specificity

"Set up the AWS DevOps Agent and AWS Security Agent connections" names the domain and one concrete action, but coverage is not comprehensive — what setup involves (MCP connection, IAM role, S3 bucket) only appears in the body, not the description. This matches anchor 3 (domain plus 1-2 concrete actions), not 4, which requires several specific actions listed.

3 / 5

Completeness

It explicitly answers both what ("Set up the AWS DevOps Agent and AWS Security Agent connections") and when ("Use when the user says 'set up', 'configure', 'connect', or when MCP tools are missing") with concrete trigger phrases, matching anchor 5. It is not 4 because the when-clause is already explicit and specific, not merely adequate.

5 / 5

Trigger Term Quality

The quoted triggers "set up", "configure", "connect", and "when MCP tools are missing" are natural phrases users would say, including a useful failure-mode trigger. It sits at anchor 4 rather than 5 because common variations like "agent", "AWS", "install", or "onboard" are missing.

4 / 5

Distinctiveness Conflict Risk

The named AWS DevOps and Security Agents create a distinct niche, but the generic triggers "set up", "configure", and "connect" could also fire for other setup or configuration skills, matching anchor 4 (mostly distinct, minor overlap risk). It is not 5 because the triggers alone are not uniquely tied to this skill.

4 / 5

Total

16

/

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.