deploying-custom-domain-rest-api

Deploys a Regional REST API with a custom domain name, a Lambda backend function, and a request-based Lambda authorizer using AWS CLI. Covers ACM certificate provisioning, API Gateway REST API creation, Lambda function deployment, request authorizer setup, custom domain configuration, base path mapping, and Route 53 DNS record creation. Trigger keywords: custom domain, REST API, Lambda, Route 53, API Gateway, regional endpoint, request authorizer, base path mapping.

Quality

86%

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

88%Weight 40%Scale 1-5

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

A thorough, highly executable SOP with concrete commands, real bundle files, and strong validation checkpoints across a complex multi-resource AWS deployment. Minor conciseness and structure improvements are possible but the workflow is clear and actionable.

Dimension	Reasoning	Score
Conciseness	The body is dense with executable commands and MUST constraints rather than concepts Claude already knows, but the architecture list appears in both the Overview and the Step 9 summary, and the Example Output block is verbose.	4 / 5
Actionability	Every step gives copy-paste-ready aws-cli commands with full parameters, and all referenced bundle files (lambda-trust-policy.json, authorizer.mjs, example_function.mjs, dns-record.json, validate.sh) exist and are real.	5 / 5
Workflow Clarity	A clear 0-9 step sequence with explicit validation checkpoints (verify dependencies, wait for certificate ISSUED, verify functions, verify stage variable, validate.sh, curl test) plus a troubleshooting section providing feedback loops for error recovery.	5 / 5
Progressive Disclosure	Code and JSON templates are appropriately externalized into scripts/ with one-level-deep, clearly signaled references, though the SKILL.md itself is a long inline SOP that could be further segmented.	4 / 5
	Total	18 / 20 Passed

Description

83%Weight 40%Scale 1-5

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

A specific, well-scoped description that names concrete actions and explicit triggers for a distinctive AWS deployment niche. The trigger guidance is explicit but phrased as a keyword list rather than a natural 'Use when...' invocation clause.

Suggestions

Replace or supplement 'Trigger keywords:' with a natural 'Use when the user asks to deploy a Regional REST API with a custom domain and Lambda authorizer' sentence so the activation condition reads as a user-facing trigger.

Qualify the broad 'Lambda' and 'Route 53' keywords (e.g., 'Lambda authorizer', 'Route 53 alias record') to reduce overlap with generic Lambda/DNS skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions spanning the whole deployment ('ACM certificate provisioning, API Gateway REST API creation, Lambda function deployment, request authorizer setup, custom domain configuration, base path mapping, and Route 53 DNS record creation').	5 / 5
Completeness	Clearly states what it does and provides explicit trigger guidance via 'Trigger keywords:', but the trigger framing is more mechanical than a natural 'Use when the user asks to deploy...' clause.	4 / 5
Trigger Term Quality	Natural trigger keywords are explicitly enumerated ('custom domain, REST API, Lambda, Route 53, API Gateway, regional endpoint, request authorizer, base path mapping'), but 'Lambda' and 'Route 53' are broad on their own and a few natural variations are missing.	4 / 5
Distinctiveness Conflict Risk	The Regional REST API + custom domain + request authorizer + Route 53 combination is a distinct niche with minimal overlap risk against other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aws/agent-toolkit-for-aws
Path: skills/specialized-skills/serverless-skills/deploying-custom-domain-rest-api/SKILL.md
Commit: d6ad2e4

Reviewed: about 2 hours 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.