agents-deploy

Use when deploying your agent to AWS, or when a deploy has failed. Handles pre-flight validation, CDK/IAM/quota error diagnosis, version management, rollback, and canary deployments. Triggers on: "deploy my agent", "agentcore deploy", "deploy failed", "CDK error", "rollback", "canary deploy", "pin version", "redeploy", "deploy stuck". Not for production hardening — use agents-harden. Not for adding capabilities before deploy — use agents-build or agents-connect. Not for VPC configuration errors — use agents-build.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, executable runbook: concise, concrete commands, two sequenced paths with a validation feedback loop, and versioning detail correctly pushed to a single one-level reference. It respects Claude's competence while remaining copy-paste actionable.

Dimension	Reasoning	Score
Conciseness	Lean, action-oriented content with executable commands and no padding explaining concepts Claude already knows; every section earns its place (e.g., 'Run agentcore --version' with a one-line version gate).	3 / 3
Actionability	Copy-paste-ready bash commands throughout (validate, dry-run, IAM simulate, cdk bootstrap, ecr login) paired with concrete error strings and their exact fixes, all fully executable.	3 / 3
Workflow Clarity	Two clearly sequenced paths (pre-flight validation, diagnose failure) with numbered checks, a Step-0 version gate, and an explicit fix-then-re-run feedback loop ('After fixing, re-run agentcore deploy -y' with status checks on recurrence).	3 / 3
Progressive Disclosure	Body is a concise overview that offloads versioning/rollback/canary detail to a real one-level reference file (references/versioning.md) via a clearly signaled link; no nested references, and the file exists as referenced.	3 / 3
	Total	12 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, trigger-rich, and self-disambiguating, explicitly stating capabilities, natural trigger phrases, and exclusion boundaries against sibling skills. It uses appropriate third-person voice throughout. This is a strong, well-scoped description.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'pre-flight validation, CDK/IAM/quota error diagnosis, version management, rollback, and canary deployments' — directly matching the level-3 anchor.	3 / 3
Completeness	Explicitly answers both what it does (deploy/diagnose/rollback/canary) and when to use it via a 'Use when...' clause plus named triggers, and further disambiguates with 'Not for...' exclusions.	3 / 3
Trigger Term Quality	Provides a strong set of natural trigger phrases users would say — "deploy my agent", "agentcore deploy", "deploy failed", "CDK error", "rollback", "canary deploy", "pin version", "redeploy", "deploy stuck" — with broad coverage.	3 / 3
Distinctiveness Conflict Risk	Clear niche (deploying AgentCore agents) with distinct triggers and explicit cross-skill exclusions ('use agents-harden', 'use agents-build or agents-connect', 'use agents-build') that prevent wrong-skill activation.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: aws/agent-toolkit-for-aws
Path: plugins/aws-agents/skills/agents-deploy/SKILL.md
Commit: 222ce56

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.