CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

83

1.24x
Quality

85%

Does it follow best practices?

Impact

81%

1.24x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 well-structured, highly actionable skill body with an excellent sequenced workflow including validation checkpoints and failure-recovery loops. Its main cost is token redundancy: the Tools and Quick Start sections duplicate the Workflow's commands and scenarios, inflating the body without adding new guidance.

Suggestions

Cut the redundant Tools section's repeated command blocks (they duplicate Steps 2-4 verbatim) and keep only the input/output contracts for each script, moving the usage lines to a reference file.

Move the 45-line inline CloudFormation template into references/architecture_patterns.md, keeping only a short representative excerpt plus the generation command in the body.

Complete the truncated `aws cloudwatch put-metric-alarm ...` command (or drop it in favor of a pointer to the monitoring guidance) and reference assets/sample_input.json as the canonical example of the Step 1 requirements format.

DimensionReasoningScore

Conciseness

There is no conceptual padding, but the body repeats itself: the Tools section restates the exact commands already shown in Workflow Steps 2-4, the Quick Start section re-covers scenarios the workflow and Input Requirements table already handle, and ~45 lines of CloudFormation YAML sit inline despite the note saying full templates live in references. This fits 'mostly efficient but could be tightened' (3) rather than the noticeably-padded anchor 2, since everything is operational rather than explanatory.

3 / 5

Actionability

Nearly all guidance is copy-paste executable: full python script invocations with flags, a complete SAM/CloudFormation template, complete aws CLI deploy and failure-recovery commands. Minor gaps keep it at 4 rather than 5: `aws cloudwatch put-metric-alarm --alarm-name high-errors ...` is truncated with an ellipsis, and the CDK snippet is an illustrative fragment rather than runnable code.

4 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with an explicit validation checkpoint in Step 2 ("Confirm the recommended pattern matches the team's operational maturity and compliance requirements") and a full error-recovery feedback loop in Step 6 (describe-stack-events diagnosis → fix → delete → wait for stack-delete-complete → redeploy) plus common failure causes. This matches the anchor with explicit validation steps and feedback loops for error recovery.

5 / 5

Progressive Disclosure

Structure is good: all three referenced documents (architecture_patterns.md, service_selection.md, best_practices.md) are real files, one level deep, and clearly signaled via a Reference Documentation table with content summaries. It stays at 4 rather than 5 because the ~45-line inline CloudFormation template and duplicated command details are content that could live in references, and the bundle's assets/ files (sample_input.json, expected_output.json) are never referenced from the body — minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

88%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 description: third-person voice, explicit what-and-when structure, concrete trigger phrases, and named services. The only weaknesses are a few missing synonyms (CDK, Terraform) and slight overlap risk with generic cost-optimization or CI/CD skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Design AWS architectures", "create CloudFormation templates", "optimize AWS costs", "set up CI/CD pipelines", or "migrate to AWS" — plus a named service roster ("Lambda, API Gateway, DynamoDB, ECS, Aurora"), matching the comprehensive-coverage anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

It explicitly answers both 'what' ("Design AWS architectures for startups using serverless patterns and IaC templates") and 'when' with a concrete "Use when asked to..." clause enumerating five trigger scenarios — the exact structure of the anchor-5 example. A missing trigger clause would have capped it at 3, but it is present and specific.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are present ("design serverless architecture", "create CloudFormation templates", "optimize AWS costs", "migrate to AWS"), but a few common variants are missing (e.g., Terraform, CDK, "reduce my AWS bill"), which fits anchor 4 rather than the fully comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The AWS/serverless/CloudFormation niche is clearly staked, but "optimize AWS costs" and "set up CI/CD pipelines" could bleed into a dedicated cost-optimization or CI/CD skill — minor overlap with closely related skills, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.