---
slug: "aws-cdk-skill-plugin"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/kndoshn/aws-cdk-skill-plugin@main/README.md"
repo: "https://github.com/kndoshn/aws-cdk-skill-plugin"
source_file: "README.md"
branch: "main"
---
# AWS CDK Skill Plugin for Claude Code

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![AWS CDK](https://img.shields.io/badge/AWS%20CDK-v2-orange?logo=amazon-aws)](https://aws.amazon.com/cdk/)

A Claude Code plugin that provides expert-level guidance for engineering AWS CDK v2 applications with safe CloudFormation deployments.

---

## Features

- **Risk-aware deployments**: Analyzes `cdk diff` for replacements, IAM changes, data loss, and cross-stack exports
- **Repo-first approach**: Detects language, CDK version, entrypoints, and existing patterns before making changes
- **Safe refactoring**: Guides construct/stack restructuring without triggering resource replacements
- **Troubleshooting**: Covers bootstrap, asset, pipeline, and synthesis failures
- **Governance**: Supports tags, encryption, logging, boundaries, and policy checks

---

## What's Included

```
skills/developing-with-aws-cdk/
├── SKILL.md              # Main instructions (loaded by Claude Code)
├── README.md             # Skill overview
├── EVALS.md              # Prompts for testing the Skill
├── reference/            # Deep documentation (loaded on demand)
│   ├── WORKFLOWS.md
│   ├── REPO_DISCOVERY.md
│   ├── RISK_MODEL.md
│   ├── REFACTORING_AND_IDENTITY.md
│   ├── BOOTSTRAP_AND_SYNTHESIZERS.md
│   ├── DEPLOYMENT_AND_RELEASES.md
│   ├── ASSETS_AND_BUNDLING.md
│   ├── CDK_PIPELINES.md
│   ├── TESTING_AND_VALIDATION.md
│   ├── GOVERNANCE_AND_GUARDRAILS.md
│   └── TROUBLESHOOTING.md
├── templates/            # Copy-paste templates for PRs and runbooks
│   ├── PR_RISK_SUMMARY.md
│   ├── DIFF_REVIEW.md
│   ├── MIGRATION_PLAN.md
│   ├── RELEASE_RUNBOOK.md
│   └── INCIDENT_REPORT.md
└── scripts/              # Diagnostic and analysis tools
    ├── repo_profile.py   # Repo inventory (language, versions, entrypoints)
    ├── parse_cdk_diff.py # Parse cdk diff into JSON/Markdown
    └── cdk_risk_report.py # Generate risk reports from synth+diff
```

---

## Installation

### Option A: As a Claude Code plugin (recommended)

```bash
git clone https://github.com/kndoshn/aws-cdk-skill-plugin.git
```

Then register the plugin in Claude Code:

```bash
claude plugins:add /path/to/aws-cdk-skill-plugin
```

Or add to your Claude Code settings manually.

### Option B: Copy into your project

```bash
mkdir -p .claude/skills
cp -R skills/developing-with-aws-cdk .claude/skills/
```

### Option C: Personal installation

```bash
cp -R skills/developing-with-aws-cdk ~/.claude/skills/
```

---

## Usage

After installation, ask Claude Code for AWS CDK-related tasks. The Skill activates automatically when your request matches its scope.

### Example Prompts

```
"Review this CDK PR and summarize the deployment risk."
"Refactor this construct to a separate stack without replacements."
"Why is cdk synth failing with a bootstrap version error?"
"Add a CDK Pipeline with prod approval gates."
"Troubleshoot this cross-stack export removal."
```

---

## Documentation

See the Skill's own documentation for details:

- [SKILL.md](https://github.com/kndoshn/aws-cdk-skill-plugin/blob/HEAD/skills/developing-with-aws-cdk/SKILL.md) - Main instructions
- [README.md](https://github.com/kndoshn/aws-cdk-skill-plugin/blob/HEAD/skills/developing-with-aws-cdk/README.md) - Skill overview
- [EVALS.md](https://github.com/kndoshn/aws-cdk-skill-plugin/blob/HEAD/skills/developing-with-aws-cdk/EVALS.md) - Evaluation prompts

---

## Scripts

Run these scripts for repo analysis:

```bash
# Repo inventory
python skills/developing-with-aws-cdk/scripts/repo_profile.py --project . --md

# Parse cdk diff output
python skills/developing-with-aws-cdk/scripts/parse_cdk_diff.py --file diff.txt --md

# Generate risk report
python skills/developing-with-aws-cdk/scripts/cdk_risk_report.py --project . --out reports
```

---

## Compatibility

- **AWS CDK**: v2 (aws-cdk-lib)
- **Languages**: TypeScript, Python, Java, C#, Go
- **Environments**: Local development, CI/CD pipelines, CDK Pipelines

---

## License

MIT