Aws Cdk

This is your go-to when you're working with AWS CDK in TypeScript or Python. It knows the sharp edges that actually matter: construct ID changes cause resource replacement, removing cross-stack references creates deployment deadlocks, and S3 buckets need both removalPolicy and autoDeleteObjects to actually delete. The troubleshooting guide maps CDK errors to their real CloudFormation causes, which saves hours of confusion. It covers the full workflow from bootstrapping through cdk-nag compliance checks, drift detection, importing existing resources, and safe refactoring. Honestly, the critical warnings section alone is worth having this loaded if you deploy CDK stacks to production.

skills.sh installs: 10.1K
GitHub stars: 3.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aws/agent-toolkit-for-aws --skill aws-cdk --agent claude-code

Installs into .claude/skills of the current project.

Files

AWS CDK

Overview

Domain expertise for CDK construct authoring, deployment workflows, compliance, drift, importing resources, safe refactoring, and troubleshooting CDK CLI / CloudFormation errors.

When NOT to use: Raw CloudFormation YAML/JSON. SAM. Terraform/Pulumi. CI/CD beyond CDK Pipelines. Use builtin knowledge or specialized skills for these.

Critical Warnings

Deadly embrace: Removing a cross-stack reference deadlocks deployment (Export ... cannot be deleted as it is in use by ...). Preferred fix: weaken the reference first — CrossStackReferences.of($RESOURCE).produce(ReferenceStrength.BOTH) then WEAK, then remove (three deploys). Legacy fallback: two-deploy this.exportValue() recipe. See troubleshooting-deployment.

Construct ID changes cause replacement: Renaming/moving a construct changes its logical ID → CloudFormation replaces the resource (data loss for stateful resources). Always cdk diff before deploy. See refactor-and-prevent-replacement.

SKILL.md on GitHub