Skip to content

feat(aws-serverless): add aws-lambda-microvms skill - #202

Merged
bfreiberg merged 5 commits into
awslabs:mainfrom
bfreiberg:feat/add-aws-lambda-microvms-skill
Jun 23, 2026
Merged

feat(aws-serverless): add aws-lambda-microvms skill#202
bfreiberg merged 5 commits into
awslabs:mainfrom
bfreiberg:feat/add-aws-lambda-microvms-skill

Conversation

@bfreiberg

@bfreibergbfreiberg commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

What

Adds the aws-lambda-microvms skill to the aws-serverless plugin.

AWS Lambda MicroVMs combine Firecracker VM isolation with container-like efficiency — snapshot-resumable, suspend/resume, dedicated HTTPS endpoint, up to 8-hour lifetimes. The skill covers building, running, debugging, and operating MicroVM applications across six references: getting started, lifecycle model, networking/connectors, IAM and security, snapshots and uniqueness, and troubleshooting.

Changes

  • New skill: plugins/aws-serverless/skills/aws-lambda-microvms/ (SKILL.md + 6 references).
  • Register microvms/firecracker keywords in the plugin manifests (.claude-plugin/plugin.json, .codex-plugin/plugin.json) and the root .claude-plugin/marketplace.json entry.
  • Bump the aws-serverless plugin version to 1.2.0.

Notes

  • Frontmatter conforms to schemas/skill-frontmatter.schema.json (name, description, argument-hint, metadata.tags).
  • All guidance uses standard AWS CLI syntax so it works with or without an MCP server. The same skill is published in aws/agent-toolkit-for-aws.

Testing

  • markdownlint-cli2 (incl. SKILL.md custom rules) → 0 errors in the new skill.
  • validate-cross-refs.cjs → 0 errors.
  • validate-references.py → 0 broken links; validate-size.py → skill within limits.
  • All modified JSON manifests validated.

Contributor Statement

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

Add the AWS Lambda MicroVMs skill to the aws-serverless plugin, covering
building, running, debugging, and operating Firecracker-isolated,
snapshot-resumable MicroVM applications: lifecycle and suspend/resume,
networking and connectors, IAM and security, snapshots/uniqueness, and
troubleshooting.
Frontmatter follows the repo skill-frontmatter schema (description,
argument-hint, metadata.tags). Register microvms/firecracker keywords in the
plugin manifests (.claude-plugin, .codex-plugin) and the root marketplace
entry, and bump the aws-serverless plugin version to 1.2.0.
@bfreiberg
bfreiberg requested review from a team as code ownersJune 22, 2026 22:16
@bfreiberg
bfreiberg enabled auto-merge June 22, 2026 22:24
Signed-off-by: Ben <9841563+bfreiberg@users.noreply.github.com>
jaycol-aws
jaycol-aws previously approved these changes Jun 23, 2026

@jaycol-awsjaycol-aws left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved; noted that docs need to be updated re: sts:TagSession not being required and HTTP_INGRESS being a supported ingress type.

- Use full image ARN (colon-form microvm-image:name) consistently for
--image-identifier across SKILL.md and all references; the bare name is
rejected by the API.
- Normalize --image-version to the full major.minor string (1.0).
- Align the trust-policy SourceArn to the colon ARN form.
- Point the regional-availability step at the concrete
list-managed-microvm-images command.
- Clarify idlePolicy is optional but its fields are required when supplied,
and that maximumDurationInSeconds is a separate RunMicrovm flag.
- Reword the /ready and /validate hook timeout guidance to remove the
self-contradictory phrasing.
@bfreiberg
bfreiberg added this pull request to the merge queueJun 23, 2026
Merged via the queue into awslabs:main with commit ba79e65Jun 23, 2026
22 checks passed
@bfreiberg
bfreiberg deleted the feat/add-aws-lambda-microvms-skill branch June 23, 2026 20:06
sbbhimji added a commit to sbbhimji/agent-plugins that referenced this pull request Jun 30, 2026
main already advanced aws-serverless to 1.2.0 via the aws-lambda-microvms skill (awslabs#202). Bump this PR to 1.3.0 to avoid a duplicate-version collision; the LMI region/scheduled-scaling additions are backward-compatible features (minor bump from 1.2.0).
github-merge-queueBot pushed a commit that referenced this pull request Jun 30, 2026
…uled scaling (#201)
* docs(aws-serverless): update LMI skill for region expansion and scheduled scaling
- Region availability: now all commercial AWS Regions except Israel (Tel Aviv), Middle East (Bahrain), Middle East (UAE), and Asia Pacific (Auckland); update Unsupported Region handling.
- Scheduled scaling: document EventBridge Scheduler-based scheduled scaling of Min/Max execution environments for predictable traffic (SKILL.md, configuration-guide.md, infrastructure-setup.md).
* Add migration assessment formulas and fix LMI configuration defaults
- Add formulas for deriving MaxConcurrency, MemorySize, and
MinExecutionEnvironments
from Lambda Insights metrics (cpu_total_time, memory_utilization,
ConcurrentExecutions)
- Add fallback guidance when Lambda Insights is not available
- Add Lambda Insights enablement instructions
- Fix default memory-to-vCPU ratio from 4:1 to 2:1 (matches public
docs and CDK defaults)
- Fix weighted alias traffic shifting claim (not currently supported
for LMI)
- Add testing phase troubleshooting guidance (CPUThrottles,
MemoryThrottles,
DiskThrottles, ConcurrencyThrottles, low CPU utilization)
- Update Best Practices to align with corrected defaults
* docs(aws-serverless): fix Lambda Insights link and troubleshooting.md formatting
Follow-up to the migration-assessment PR: correct the broken Lambda Insights versions doc URL and add blank lines around lists in troubleshooting.md so dprint/markdownlint pass.
* chore(aws-serverless): bump plugin version to 1.2.0
Region expansion + scheduled scaling + migration-assessment guidance are backward-compatible feature additions to the LMI skill (minor bump). Updated plugin.json, .codex-plugin/plugin.json, and marketplace.json.
* fix(aws-serverless): cap LMI MemorySize formula at 32 GB maximum
Address review feedback: the MemorySize derivation had a floor (max with 2048) but no ceiling, so it could exceed the 32 GB LMI limit. Wrap in min(32768, ...) to cap at the maximum.
* chore(aws-serverless): bump version to 1.3.0
main already advanced aws-serverless to 1.2.0 via the aws-lambda-microvms skill (#202). Bump this PR to 1.3.0 to avoid a duplicate-version collision; the LMI region/scheduled-scaling additions are backward-compatible features (minor bump from 1.2.0).
---------
Co-authored-by: Alain Krok <alkrok@amazon.com>
Co-authored-by: Craig Phillips <pcrai@amazon.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@bfreiberg@krokoko@jaycol-aws