CtrlK
BlogDocsLog inGet started
Tessl Logo

aws-cdk

Authors, deploys, and troubleshoots AWS infrastructure using CDK with TypeScript or Python. Covers best practices, stack architecture, and construct patterns. Applies when writing CDK constructs, bootstrapping environments, running cdk deploy/synth/diff, fixing CDK or CloudFormation errors, planning stack structure, importing existing resources, resolving drift, or refactoring stacks without resource replacement.

73

Quality

90%

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

The canonical home for this skill is aws-cdk in aws/agent-toolkit-for-aws

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary SKILL.md body: dense, command-first, with explicit validation checkpoints before destructive operations and a clean one-level-deep reference structure covering the whole domain. The only deductions are minor — an inline CLI version number and deliberate repetition of the hotswap/express production warning.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — terse tables, error→fix rows, and command snippets with no concept explanations — but the inline version pin "CLI ≥ 2.1120.0" is time-sensitive information outside a deprecated/old-patterns section, and the hotswap/express production prohibition is repeated across Critical Warnings, Common Workflows, the Fast Deployments section, and three troubleshooting rows. These minor instances could be trimmed, matching anchor 4 rather than the lean-everywhere anchor 5.

4 / 5

Actionability

Nearly every entry is a copy-paste-ready command or code snippet — "cdk bootstrap aws://$ACCOUNT/$REGION", "cdk rollback $STACK --orphan <LogicalId>", "CrossStackReferences.of($RESOURCE).produce(ReferenceStrength.BOTH)", "Aspects.of(app).add(new AwsSolutionsChecks())", "rm -rf cdk.out" with "--output ./cdk.out.$BUILD_ID" for CI — and the 16-row troubleshooting table covers the common failure cases with specific fixes.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints for destructive operations: "cdk synth --strict → cdk diff → cdk deploy" with "Always diff before deploy to production", "cdk drift $STACK (use --fail in CI)", and the deadly-embrace fix spelled out as a three-deploy weakening sequence. Error-recovery feedback loops (rollback via "cdk rollback", roll-forward for failed --express, "--revert-drift") are present throughout the troubleshooting table.

5 / 5

Progressive Disclosure

The ~80-line body is a true overview: each section (warnings, workflows, troubleshooting, construct patterns) links to a well-signaled, one-level-deep reference file, and all 10 linked files exist in references/ and map cleanly to sections with no inlined content that belongs elsewhere and no nested references.

5 / 5

Total

19

/

20

Passed

Description

87%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 states what the skill does and when to use it, with a rich set of natural command-level trigger phrases. The only weakness is the mildly generic middle sentence ("Covers best practices, stack architecture, and construct patterns") and a few missing synonyms such as "infrastructure as code".

Suggestions

Replace the generic "Covers best practices, stack architecture, and construct patterns" with the concrete capabilities it glosses (e.g., "uses L2 construct patterns, cdk-nag compliance checks, and stack architecture guidance").

Add common entry-point terms like "infrastructure as code" or "IaC" to catch users who describe the domain without naming CDK.

DimensionReasoningScore

Specificity

"Authors, deploys, and troubleshoots AWS infrastructure using CDK with TypeScript or Python" names the domain with concrete verbs, and the when-clause lists seven specific activities (bootstrapping, running cdk deploy/synth/diff, importing existing resources, resolving drift). However, "Covers best practices, stack architecture, and construct patterns" is generic filler, leaving minor gaps in coverage rather than comprehensive concrete actions.

4 / 5

Completeness

Clearly answers both: the "what" ("Authors, deploys, and troubleshoots AWS infrastructure using CDK with TypeScript or Python") and an explicit "when" ("Applies when writing CDK constructs, bootstrapping environments, running cdk deploy/synth/diff, fixing CDK or CloudFormation errors...") with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are well covered — "cdk deploy/synth/diff", "bootstrapping environments", "CloudFormation errors", "resolving drift", "refactoring stacks without resource replacement" — but a few common terms are missing ("infrastructure as code", "IaC", "cdk init"), which matches the "good keyword coverage; a few natural terms missing" anchor rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (AWS CDK specifically, with TypeScript/Python) with command-level triggers like "cdk deploy/synth/diff" and "bootstrapping" that would not fire for generic CloudFormation, Terraform, or general-AWS skills, giving minimal conflict risk.

5 / 5

Total

18

/

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.