setting-up-cloudtrail-multi-region — Claude Code skill: how to install
Configures a multi-region AWS CloudTrail trail with S3 storage and CloudWatch Logs streaming. Useful for centralizing API audit logs and running security queries.
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a claude-codeWhat setting-up-cloudtrail-multi-region does
This skill guides your coding agent through creating a multi-region AWS CloudTrail configuration across all regions. It establishes centralized API activity logging into an S3 bucket, streams logs to CloudWatch Logs, and sets up CloudWatch Logs Insights queries for compliance auditing.
The skill outlines steps from references/cloudtrail-multi-region-setup.md and provides targeted troubleshooting. It instructs you to check caller credentials with aws sts get-caller-identity and explicitly warns against attaching *FullAccess managed policies. The CloudWatch log group must reside in the exact same region as the trail itself.
Log delivery requires patience. Initial events need 5 to 15 minutes to show up after running start-logging, while opt-in AWS regions can take up to 24 hours to surface events.
What it helps with
- enable centralized AWS API activity logging across all regions
- route CloudTrail events to Amazon S3 and CloudWatch Logs
- configure CloudWatch Logs Insights queries for security audits
- troubleshoot trail logging failures and permission denied errors
Example prompts for the agent
- Set up a multi-region CloudTrail trail with S3 storage and CloudWatch Logs
- Check why events are missing from CloudWatch after creating my trail
- Configure CloudWatch Logs Insights queries for audit analysis
How to install setting-up-cloudtrail-multi-region
1Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a claude-code2Manually: put the files in place
~/.claude/skills/setting-up-cloudtrail-multi-region/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/setting-up-cloudtrail-multi-region/
1Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a codex2Manually: put the files in place
.agents/skills/setting-up-cloudtrail-multi-region/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a cursor2Manually: put the files in place
.cursor/skills/setting-up-cloudtrail-multi-region/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aws/agent-toolkit-for-aws setting-up-cloudtrail-multi-region2Manually: put the files in place
.github/skills/setting-up-cloudtrail-multi-region/SKILL.md1Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a gemini-cli2Platform CLI
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path skills/specialized-skills/operations-skills/setting-up-cloudtrail-multi-regionManually: put the files in place
.devin/skills/setting-up-cloudtrail-multi-region/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about setting-up-cloudtrail-multi-region
How to install setting-up-cloudtrail-multi-region in Claude Code?
Run npx skills add aws/agent-toolkit-for-aws --skill setting-up-cloudtrail-multi-region -a claude-code in your terminal.
What does setting-up-cloudtrail-multi-region do?
It provides domain guidance to configure a multi-region AWS CloudTrail trail, store logs in S3, integrate CloudWatch Logs, and run security analysis queries.
Why are opt-in region events missing from the trail logs?
Events from opt-in regions take longer to propagate. The skill notes you should wait up to 24 hours before troubleshooting missing opt-in events.
Source text
SKILL.md · Apache-2.0
--- name: setting-up-cloudtrail-multi-region description: Enables a multi-region AWS CloudTrail trail with S3 log storage, CloudWatch Logs integration, and CloudWatch Logs Insights queries for security monitoring and compliance auditing. Use when setting up centralized API activity logging across all AWS regions. version: 1 --- # Setting Up CloudTrail Multi-Region ## Overview Domain expertise for enabling AWS CloudTrail across all regions to capture comprehensive API activity logs and configuring CloudWatch Logs Insights for security monitoring, compliance auditing, and operational analysis. ## Set up a multi-region trail To create a centralized multi-region CloudTrail trail with S3 storage, CloudWatch Logs integration, and log analysis, follow the procedure exactly. See [CloudTrail multi-region setup procedure](references/cloudtrail-multi-region-setup.md). ## Troubleshooting ### S3 bucket already exists Choose a different globally unique name, or add a timestamp or organization identifier. ### Permission denied errors Verify your identity with `aws sts get-caller-identity`. Ensure your user/role has required actions attached. Do NOT use `*FullAccess` managed policies. ### Trail not logging Verify IAM role permissions, check S3 bucket policy allows CloudTrail access, and ensure the trail is started with `start-logging`. ### Missing events in CloudWatch Allow 5-15 minutes for initial log delivery. Verify the CloudWatch Logs role ARN is correct and the log group exists in the same region as the trail. ### Opt-in region events not appearing This is normal — events from opt-in regions may take several hours. Wait up to 24 hours before investigating further.
© aws · Apache-2.0 · aws/agent-toolkit-for-aws