| name | example |
| description | TEMPLATE — Replace with one paragraph that describes what this skill builds and
when it should activate. Include trigger keywords,
e.g., "build me a customer profile system".
This text drives skill activation matching across Claude Code, Kiro, and Quick.
|
| license | MIT |
| metadata | {"version":"1.0","author":"aws-solution-skills"} |
Purpose
1-2 paragraphs on what this skill builds and for whom.
Knowledge sources
shared/reference/architecture.md — architecture decisions and rationale
shared/reference/decision-tree.md — conditional logic
shared/reference/aws-services.md — service / model catalog
shared/reference/constraints.md — known limits and gotchas
shared/patterns/cdk-stacks.md — full CDK stack source
shared/patterns/lambda-handlers.md — full Lambda handler source
shared/patterns/frontend-pages.md — React + Tailwind + shadcn/ui pages
shared/examples/ — industry-specific golden examples
Workflow
Phase 1: Discovery (conversational requirements)
List discovery questions the agent asks the user. Skip what is already known.
⛔ GATE 1: summarize requirements, await user confirmation.
Phase 2: Architecture Design
- Apply
shared/reference/decision-tree.md
- Cost estimate from
shared/reference/aws-services.md
- Verify regional availability via AWS Knowledge MCP
⛔ GATE 2: present design table, await user confirmation.
Phase 3: Code Generation
Reference shared/patterns/* to emit files in this order:
package.json, tsconfig.json, cdk.json
config/schema.yaml
lib/*-stack.ts
backend/lambdas/*/handler.ts
frontend/src/...
scripts/*.sh
Phase 4: Validate
cdk synth must pass.
Phase 5: Deploy
Provide step-by-step deployment guide.
Generation rules
- TypeScript + aws-cdk-lib v2
- Node 20+ Lambda, esbuild
- React 18 + Tailwind v3 + shadcn/ui (NOT Cloudscape)
- AWS SDK v3 modular imports
Hard Constraints
List 1-line items. Full detail lives in shared/reference/constraints.md. Examples:
- — see
shared/reference/constraints.md #N
- ...
When to call MCP
| When | MCP | Call |
|---|
| Region availability check | AWS Knowledge | aws_get_regional_availability |
| Latest model ID lookup | AWS Knowledge | aws_search_documentation |
| CDK construct verification | AWS Knowledge | aws_read_documentation |