aws-solution-architect

Design AWS architectures for startups using serverless patterns and IaC templates. Use when asked to design serverless architecture, create CloudFormation templates, optimize AWS costs, set up CI/CD pipelines, or migrate to AWS. Covers Lambda, API Gateway, DynamoDB, ECS, Aurora, and cost optimization.

1.24x

Quality

80%

Does it follow best practices?

Impact

81%

1.24x

Average score across 6 eval scenarios

Securityby

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./engineering-team/skills/aws-solution-architect/SKILL.md

Quality

Content

67%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, actionable skill body with a well-sequenced workflow and validation feedback loop for destructive infrastructure operations. Tightening by relocating the full inlined CloudFormation/CDK templates into references and de-duplicating Quick Start against the Workflow would improve conciseness and progressive disclosure.

Suggestions

Move the full inlined CloudFormation YAML and CDK TypeScript snippets into references/architecture_patterns.md (or scripts output), keeping only a compact representative excerpt inline.

Trim the Quick Start section so it does not restate the Workflow steps, or reframe it purely as example prompts/results.

Complete the truncated CloudWatch alarm command in Step 6 rather than ending it with `...`, to keep every command copy-paste ready.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with commands, tables, and code blocks, but it inlines a ~45-line CloudFormation YAML and a CDK snippet that largely belong in the provided reference/script files, and the Quick Start section restates Workflow content.	3 / 5
Actionability	Highly executable guidance throughout — concrete `python scripts/...` invocations, copy-paste CloudFormation/CDK blocks, deploy CLI commands, and example JSON input/output — with only minor truncation (the CloudWatch alarm command ends with `...`).	4 / 5
Workflow Clarity	Six clearly sequenced steps include an explicit validation checkpoint in Step 2 and a full diagnose→fix→delete→wait→redeploy feedback loop for failed stacks plus common failure causes; a few later steps lack equivalent checkpoints.	4 / 5
Progressive Disclosure	The body is an overview pointing to three real reference files and three real scripts, each signaled with purpose and summarized in a navigation table; some detailed templates are inlined rather than moved to references, preventing a perfect 5.	4 / 5
	Total	15 / 20 Passed

Description

92%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 strong, well-structured description that concretely states capabilities and provides explicit trigger guidance. Minor expansion of trigger synonyms (IaC, CDK, Terraform) would push trigger term quality to full marks.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("design serverless architecture, create CloudFormation templates, optimize AWS costs, set up CI/CD pipelines, or migrate to AWS") plus named services, giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers what ("Design AWS architectures for startups using serverless patterns and IaC templates") and when via a concrete "Use when..." clause with multiple trigger phrases.	5 / 5
Trigger Term Quality	Strong natural trigger phrases users would say ("optimize AWS costs", "set up CI/CD pipelines", "migrate to AWS", "create CloudFormation templates"), but omits common synonyms/extensions like "IaC", "Terraform", or "CDK" that the body covers.	4 / 5
Distinctiveness Conflict Risk	Clearly scoped to AWS startup serverless architecture with distinct, specific triggers, making overlap with unrelated skills minimal.	5 / 5
	Total	19 / 20 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: alirezarezvani/claude-skills
Path: engineering-team/skills/aws-solution-architect/SKILL.md
Commit: 19392f7

Reviewed: 20 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.