aws-cloudformation Skill from AWS: Author, Validate and Troubleshoot CloudFormation
AWS's own skill for writing CloudFormation templates with secure defaults, validating them before deploy and finding why a stack failed.
- Installs
- 9.1K
- on skills.sh
- Stars
- 3.4K
- on GitHub
- Files
- 15
- besides SKILL.md
- Updated
- Oct 2026
- last repo commit
aws-cloudformation makes the agent follow AWS's own procedures for the whole CloudFormation lifecycle. It writes templates with secure defaults, runs local validation (cfn-lint or cloudformation-validate), cfn-guard security checks and account-aware pre-deployment validation, and diagnoses failed stacks from CloudFormation events and CloudTrail.
It works on plain CloudFormation YAML or JSON, not CDK. Its steps call AWS APIs through the AWS CLI or the AWS MCP server with your credentials. It treats template text as untrusted data, and the SKILL.md says creating, updating or deleting live stacks needs your approval. It lives in AWS's own repo.
Good for
- Developers writing or changing CloudFormation YAML or JSON templates
- Engineers whose stack deployment failed or is stuck in a rollback state
- Teams who want security checks run before every deploy
Install aws-cloudformation
Claude Code
- 1
Copy this prompt.
Install the aws-cloudformation skill in Claude Code. Run this command: /plugin install aws-core@claude-plugins-official /reload-plugins Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Pick one route. The plugin route installs aws-core: 25 skills (counted from plugins/aws-core/skills in the repo tree), an AWS MCP server entry in .mcp.json, and two PreToolUse hooks (Bash, and AWS or MCP tool calls) that run secret-safety.py; see the safety section. The skills routes install skill files only. The skill's steps use the AWS CLI with your credentials; the AWS MCP server is recommended but not required. It needs no sibling skills. If the plugin shows "Plugin not found", run /plugin marketplace update claude-plugins-official first, as the README says.
From the project README. Source.
What's in the skill
When it loads
Authors, validates, and troubleshoots AWS CloudFormation templates. Covers template authoring with secure defaults, local validation with either cfn-lint or cloudformation-validate, cfn-guard security and compliance checks as a recommended default, account-aware CloudFormation service pre-deployment validation, CloudFormation Express mode for faster deployments, and root-cause diagnosis of failed stacks using CloudFormation events and CloudTrail correlation. Also covers author-time template intelligence with the CloudFormation Language Server and published cloudformation-validate libraries.
Sections in SKILL.md
- Overview
- Guardrail — where this skill's own files live (MCP vs local install)
- Common Tasks
- Configure author-time template intelligence
- Understand, explain, or document a template
- Author a new template or modify an existing one
- Validate a template before deployment
- Deploy faster with Express mode
- Troubleshoot a failed deployment
- Decision Guide
- CloudFormation vs CDK
- Troubleshooting
- Cross-Stack Reference Safety
- Conditional Resource Coupling
- Security Group Blast Radius
- DeletionPolicy Preservation for Stateful Resources
Key facts
- Installs on skills.sh
- 9,080 (Nov 2, 2026)
- Last commit
- Oct 30, 2026
What it includes
Sets up the CloudFormation Language Server in an editor or AI client
Points to a guide for completion, diagnostics, hover docs and refactoring. It tells the agent to follow AWS Toolkit or standalone install docs.
Runs code ·
Configure template intelligenceReads embedded Description, Metadata and comments to explain intent
A read-only use. If a template has little context, the agent infers purpose from its resources and structure.
Try: “What does this CloudFormation template do and why?”
Read ·
Understand or document a templateApplies secure defaults, a best-practices checklist and a property lookup
Defaults include blocking public S3 access, encryption, Retain policies on stateful resources, no hard-coded names and no plain-text secrets. It also records design context in Metadata and adds an AWSAgentToolkit marker.
Write ·
Author or modify a templateLocal validator, then cfn-guard, then account-aware pre-deployment checks
Each layer is reported separately. Pre-deployment validation uses CloudFormation change sets in your account. Tool installs need your approval.
Runs code ·
Validate before deployUses create-stack or update-stack with Express mode for fast dev feedback
Not for production flows needing resources ready at once. SKILL.md says Express is not CDK hotswap and that aws cloudformation deploy does not support it.
Delete ·
Deploy with Express modeClassifies failures and rollback cascades from events and CloudTrail
Uses describe-events, not the legacy describe-stack-events.
Network ·
Troubleshoot a failed stackSix must-follow checks before editing exports, conditions, security groups and more
Cross-stack references, conditional resource coupling, security group blast radius, DeletionPolicy, parameter propagation and template size limits, each detailed in template-safety-guidance.md.
Read ·
Safety procedures
From the official docs
Permissions
High risk
The skill can create, update and delete live AWS stacks with your credentials, although its procedures require your approval first. Use a least-privilege role in a development account, and read what the plugin route adds before installing.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can change and delete live AWS stacks
Procedures cover create-stack, update-stack, change sets and delete-stack, and say to get your explicit approval first. Validation creates change sets in your account, and the CREATE type leaves a stack in REVIEW_IN_PROGRESS until cleaned up. github.com
Express mode turns rollback off by default
SKILL.md says rollback is disabled by default in Express mode and resources keep stabilizing after the command returns. Do not use it for production flows. github.com
The plugin adds an AWS MCP server with your AWS access
aws-core's .mcp.json runs uvx mcp-proxy-for-aws-cli==1.7.0 against https://aws-mcp.us-east-1.api.aws/mcp. The plugin README says it gives authenticated access to 300+ AWS services through call_aws and runs sandboxed Python through run_script. github.com
The plugin adds two hooks that read tool calls
hooks.json runs secret-safety.py before every Bash call and before AWS and MCP tool calls. The script reads the call as JSON on stdin and returns a deny when it sees a direct Secrets Manager secret fetch; otherwise it exits without output. github.com
It installs checking tools only with your approval
cfn-lint, cfn-guard and the AWS CLI are installed after the agent asks you; the references say never to run install commands without approval. github.com
It adds an attribution marker to templates
On any template it creates or edits, SKILL.md says to add Metadata.AWSToolsMetrics.AWSAgentToolkit with the value aws-cloudformation@3. Remove it if you do not want it in your template. github.com
Technical details
| Talks to | aws-mcp.us-east-1.api.aws (plugin route) |
|---|---|
| Scopes |
|
Questions
What does the aws-cloudformation skill do?
It guides the agent through the CloudFormation lifecycle: writing templates, validating them before deployment and finding the cause of failed stacks. It is AWS's own skill and covers plain CloudFormation, not CDK.
Is it official?
Yes. It is in AWS's own agent-toolkit-for-aws repository and the plugin lists Amazon Web Services as author. The README says the aws-core plugin is on Anthropic's official marketplace.
How do I install it in Claude Code?
Use the install box above. The aws-core plugin bundles this skill with others, an AWS MCP server setting and hooks. The skills CLI route installs only the skill.
Do I need an AWS account and credentials?
For account-aware steps, yes. Those steps use the AWS CLI or the AWS MCP server with your credentials, and the references ask for ephemeral, least-privilege credentials.
Who pays for what it deploys?
The skill itself has no price. Stacks you create are billed by AWS to the account whose credentials are used, like any CloudFormation deployment.
Will it change my AWS account without asking?
The pre-deployment and Express-mode procedures say to get your explicit approval before create-stack, update-stack, executing a change set or deleting a stack. SKILL.md says destructive operations run only on your direct instruction.
Does it work in the Claude app?
We do not list a Claude app route. The skill's steps run the AWS CLI and local validators on your machine.
Is it safe?
It can create, update and delete real AWS infrastructure through your credentials, though its procedures require your approval first, and Express mode turns rollback off by default. Our advice, not AWS's: use a least-privilege role in a development account first. The plugin route also adds an MCP server setting and two hooks; the safety section lists them.
Information
updated Nov 2, 2026
- Repository
- aws/agent-toolkit-for-aws
- Folder
skills/core-skills/aws-cloudformation
Sources
Docs, issue trackers and discussions this page is built from.
Show all 9Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com