CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

working-with-aws

Baseline operating rules for any task that touches AWS. Use whenever the user asks to build, deploy, configure, inspect, or troubleshoot anything on AWS. Directs the agent to prefer the AWS MCP Server for AWS interactions, discover and load a relevant AWS skill before starting, verify uncertain details against live AWS documentation instead of guessing, prefer infrastructure-as-code (AWS CDK or CloudFormation) over one-off CLI mutations, and follow AWS Well-Architected best practices for security, cost, reliability, and operations.

Quality

82%

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

68%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 tight, highly actionable guardrails document whose rules name concrete tools, commands, and AWS-specific mechanisms rather than vague directives. Its weaknesses are thematic rather than sequenced organization with no validation checkpoint for the destructive infrastructure operations it governs, and reliance on sibling-skill references that are not present in this bundle.

Suggestions

Add a lightweight validation checkpoint for infrastructure changes (e.g., review 'cdk diff' output or a CloudFormation change set before deploying) so the destructive-operation cap on workflow clarity is lifted.

Include a minimal least-privilege policy snippet using the named 'aws:ViaAWSMCPService' / 'aws:CalledViaAWSMCP' condition keys to make the read-only-in-production rule copy-paste ready.

Trim known-concept rationale ('IaC is reviewable, repeatable, and safely destroyable') and the six-pillar enumeration to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is a lean set of directives with no concept tutorials, and includes genuinely non-obvious specifics like the '{{resolve:secretsmanager:secret-id:SecretString:json-key}}' dynamic reference and the 'aws:ViaAWSMCPService' condition keys. Not 5: a few phrases explain what Claude already knows ('IaC is reviewable, repeatable, and safely destroyable') and the six-pillar enumeration could be trimmed.

4 / 5

Actionability

Concrete, named guidance throughout — 'retrieve_skill', 'search_documentation' / 'read_documentation', forbidden commands ('secretsmanager get-secret-value' / 'batch-get-secret-value'), a copy-pasteable CloudFormation dynamic reference, and specific standing-cost examples (NAT gateways, RDS/Aurora provisioned instances, always-on load balancers). Not 5: it stops short of executable examples for the common cases (no CDK/CLI snippet, no least-privilege policy example using the named condition keys).

4 / 5

Workflow Clarity

The rules are grouped thematically rather than sequenced; only 'Before beginning a task, check whether a relevant AWS skill exists' provides explicit ordering, and verification guidance ('Verify, don't guess') is a rule rather than a checkpoint in a flow. The skill governs potentially destructive infrastructure operations yet includes no post-change validation step, so workflow clarity is capped at 3. Not 4: there is no clear overall sequence with checkpoints.

3 / 5

Progressive Disclosure

Sections are well organized (Core rules, Security defaults, Secret safety, Cost awareness) with no nested references, and the single external pointer ('See the aws-mcp-server skill for how to drive it') is clearly signaled. Not 5: no bundle files exist to resolve the referenced sibling skills, and the body slightly exceeds the ~50-line simple-skill threshold while inlining several rule sets that could live in references.

4 / 5

Total

15

/

20

Passed

Description

88%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 explicitly covers what the skill does and when to use it, with multiple concrete capability statements and natural trigger verbs. Its main weaknesses are the absence of service-level trigger synonyms and an intentionally broad AWS-wide trigger scope that overlaps sibling AWS skills.

Suggestions

Add natural service-level trigger terms users say (e.g., EC2, S3, Lambda, CloudFormation stacks, 'cloud infrastructure') to broaden keyword coverage.

Clarify the relationship to sibling skills (e.g., 'load alongside task-specific AWS skills such as aws-mcp-server') to reduce co-trigger ambiguity.

Trim the enumerated list of behaviors slightly and surface the most distinguishing rule first so scanning agents grasp the niche faster.

DimensionReasoningScore

Specificity

The description lists five explicit concrete actions — prefer the AWS MCP Server, discover and load a relevant AWS skill, verify against live AWS documentation, prefer CDK/CloudFormation over CLI mutations, and follow Well-Architected — giving comprehensive, specific coverage. Not 4: the gaps are not minor; each directive is named concretely rather than left generic.

5 / 5

Completeness

It explicitly answers both what ('Baseline operating rules... Directs the agent to prefer the AWS MCP Server... discover and load a relevant AWS skill... verify uncertain details... prefer infrastructure-as-code... follow Well-Architected') and when ('Use whenever the user asks to build, deploy, configure, inspect, or troubleshoot anything on AWS') with concrete trigger phrases. Not 4: the 'when' clause is explicit and specific, not merely adequate.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('build, deploy, configure, inspect, or troubleshoot anything on AWS'), matching what users would actually say. Not 5: it omits common service-level synonyms and terms users naturally say (e.g., EC2, S3, Lambda, 'cloud'), keeping keyword coverage good but incomplete.

4 / 5

Distinctiveness Conflict Risk

The AWS domain niche and baseline-rules role are clear and distinguishable from generic skills, but 'any task that touches AWS' intentionally co-triggers with every AWS task and overlaps closely related sibling skills such as the referenced 'aws-mcp-server'. Not 5: the trigger scope subsumes closely related AWS skills; not 3: it is far more anchored than 'somewhat specific' examples.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

mreferre/standard-plugin-agent-toolkit-aws

Path

skills/working-with-aws/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.