jeff-skill-aws-cdk-project

Configure AWS CDK TypeScript projects with a standardized cdk/ layout and Vitest tests.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/jbaranski/jeff-claude --skill jeff-skill-aws-cdk-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jeff-skill-aws-cdk-project
Source: https://github.com/jbaranski/jeff-claude/tree/main/.claude/skills/jeff-skill-aws-cdk-project
Command: npx skills add https://github.com/jbaranski/jeff-claude --skill jeff-skill-aws-cdk-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configure or update AWS CDK TypeScript projects with an opinionated layout, required dependencies, scripts, and .env usage. Use when a repo should contain a CDK project. CDK app code should live in a cdk/ folder off the root of the project with strict dependency and file structure conventions.

Core Features & Use Cases

  • Enforces a canonical repo layout with a single CDK app under cdk/ (bin, lib) and per-construct organization.
  • Standardizes environment configuration through cdk/.env and cdk/.env.example.
  • Requires unit tests (Vitest) with a dedicated test directory and coverage goals for repeatable builds and audits.
  • Provides sample App Entrypoint and Stack structure guidance.
  • Encourages repeatable build, test, synth, and deploy workflows, including CI integration.

Quick Start

Configure your repository to host a single CDK app under the cdk directory, add environment files, and use the included patterns to build, test, synth, and deploy.

Frequently Asked Questions about jeff-skill-aws-cdk-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure an AWS CDK TypeScript project for repeatable builds?

Structure your AWS CDK TypeScript project by placing a single CDK app in a dedicated cdk/ directory with bin, lib, and test subdirectories. This opinionated layout enforces per-construct file organization and environment management for repeatable builds.

What is the best way to manage environment variables in an AWS CDK project?

The best way to manage environment variables in an AWS CDK project is by standardizing through cdk/.env and cdk/.env.example files. This approach keeps environment configurations consistent and documented within the cdk directory structure.

Does this AWS CDK project setup require a specific testing framework?

Yes, this AWS CDK project setup requires Vitest for unit testing. It mandates a dedicated test directory with coverage goals to ensure repeatable builds and maintain infrastructure code quality audits.

Can I maintain multiple CDK apps in the same repository with this structure?

No, you cannot maintain multiple CDK apps with this structure. It enforces a canonical repository layout designed for a single CDK app at the repo root inside a cdk/ directory with a single stack and per-construct files.

How do I organize CDK constructs and stacks in a TypeScript repository?

Organize CDK constructs and stacks by keeping the app entrypoint in cdk/bin and defining a single stack with per-construct files in cdk/lib. This sample structure provides guidance for maintaining clear separation of infrastructure components.

Why use an opinionated AWS CDK project layout instead of the default initialization?

Use an opinionated AWS CDK project layout to enforce strict dependency and file structure conventions beyond default initialization. It standardizes environment configuration, testing, and workflows to enable repeatable synth, deploy, and CI integration processes.