cdk-review

Automate TypeScript CDK code reviews for App/Stack/Construct structure and best practices.

1|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill cdk-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cdk-review
Source: https://github.com/kasiopeiya/oidc-learning-sandbox/tree/main/.claude/skills/cdk-review
Command: npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill cdk-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CDK コードの品質とセキュリティを自動的に検証・改善するための標準化されたレビューを提供します。大規模なインフラコードの一貫性を確保し、人的ミスを減らします。

Core Features & Use Cases

  • 型安全性のチェック、命名規則、インポート順序など、TypeScript/CDK に特化した観点を自動で適用します。
  • App/Stack/Construct/Parameter の分類に基づく詳細なコードレビューを実行し、潜在的な設計上の問題を指摘します。
  • 実務でのユースケースとして、リファクタリング前のコード品質評価、セキュリティ・ベストプラクティスの適用状況確認、レビュー履歴の自動生成などがあります。

Quick Start

CDK プロジェクトのルートで cdk-reviewer-agent を起動して、CDK コードの自動品質レポートを生成します。

Frequently Asked Questions about cdk-review

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

FAQPage Schema
How do I automate CDK code reviews for TypeScript projects?

To automate CDK code reviews, run the reviewer at your project root to validate App/Stack/Construct structure, type safety, naming conventions, and L2 construct usage. This generates a quality report highlighting infrastructure issues.

What AWS CDK best practices should I check in my infrastructure code?

AWS CDK best practices include using L2 constructs, enforcing type safety, standardizing naming conventions, and applying appropriate removal policies. Automating these checks ensures consistency and reduces human error across large infrastructure deployments.

Can I check CDK App and Stack structure automatically before refactoring?

Yes, you can automatically check CDK App and Stack structure before refactoring. The reviewer validates your Construct hierarchy, Parameter classification, and import order to identify potential design issues and ensure code quality.

Does CDK code review work with TypeScript only or does it support other languages?

Automated CDK code review currently applies exclusively to TypeScript CDK projects. It validates TypeScript-specific patterns, type safety, and import ordering, making it unsuitable for Python, Java, or other CDK language bindings.

Why should I use L2 constructs instead of L1 constructs in AWS CDK?

Using L2 constructs in AWS CDK provides built-in defaults, better type safety, and simplified syntax compared to L1 constructs. Automated reviews check for L2 construct usage to ensure your infrastructure follows best practices and reduces boilerplate.