CtrlK
BlogDocsLog inGet started
Tessl Logo

aws-well-architected-review

Performs a full AWS Well-Architected Framework review evaluating every framework question across all pillars discovered from the live AWS documentation by analyzing code, IaC, and configurations to produce evidence-backed findings with Eisenhower-prioritized remediation. Supports full reviews (every framework best practice with BP ID citations), quick reviews (question-level), pillar-scoped reviews, score-mode reviews (a maturity scorecard with per-pillar scores and filtered findings), and lens-specific reviews using lenses discovered from the live AWS documentation. Triggers on mentions of Well-Architected review, WA review, WAR, pillar assessment, architecture review across pillars, workload assessment, cloud readiness evaluation, or a Well-Architected score, grade, or scorecard request. Does not apply to single-pillar deep-dives, learning WA concepts, ADRs, or migration readiness assessments.

77

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-engineered procedural skill body: a gated eight-step workflow with explicit validation gates and failure handling, concrete executable specifics throughout, and a clean one-level-deep reference structure that is verifiably real on disk. The only weakness is repetition of a few invariants (inline reporting, the template's authority) across sections.

Suggestions

State the inline-report and report-template-authority invariants once (e.g., in the 'Non-negotiable invariants' block) and let Step 7 reference them, removing the duplicate 'authoritative list' sentences within Step 7.

Trim the repeated restatement of ACQUIRE_CORPUS being mode-independent and the recall-critical section list, which both appear in two forms, to recover tokens without losing the gate semantics.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no pillar/PDF-style concept explanations, concrete status vocabulary, exact file names like "questions.jsonl" and "manifest.json"), but several invariants are restated multiple times — the inline-report requirement appears in three places and "the report template is the authoritative list" is asserted twice within Step 7 — which could be tightened. This sits between 'efficient; minor instances of over-explanation' (4) and 'lean and efficient; every token earns its place' (5), noticeably above the midpoint but not flawless.

4 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: exact tool names ("aws___read_documentation"), concrete scratch-file layout (corpus/, questions.jsonl, best-practices.jsonl, manifest.json), a five-value status vocabulary, an exact report first line ("# Well-Architected Review:"), a numbered report-section checklist, and a verbatim follow-up script. Anchor 4 would require minor gaps in executable specificity; none are present in what the body itself carries.

5 / 5

Workflow Clarity

Eight clearly sequenced steps with an explicit validation gate ("you MUST NOT begin Step 5 until corpus/manifest.json reports valid: true"), internal completeness gates in Steps 3 and 6, a coverage audit before the executive summary, and an error-recovery rule ("a surfaced error, not a gap to invent around") — matching the anchor with explicit validation, feedback loops, and checklists. Not 4, because no checkpoint is left implicit.

5 / 5

Progressive Disclosure

The body is a clear overview with a well-signaled reference list (one line each, telling you when to read each file), details correctly split into 7 reference files plus a report template asset, and all referenced paths exist on disk. Verified the bundle files contain no second-level references, so navigation is one level deep — matching the top anchor exactly.

5 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: it states concrete capabilities in third person, enumerates all supported modes with their outputs, gives explicit trigger phrases including abbreviations and synonyms, and closes with clear non-trigger boundaries. The length is justified by the density of information rather than padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "evaluating every framework question across all pillars", "analyzing code, IaC, and configurations", "evidence-backed findings with Eisenhower-prioritized remediation" — and enumerates five distinct review modes with their concrete outputs ("BP ID citations", "maturity scorecard with per-pillar scores"), matching the comprehensive-coverage anchor. It is not score 4 because coverage of what the skill does is complete rather than having minor gaps.

5 / 5

Completeness

Explicitly answers 'what' ("Performs a full AWS Well-Architected Framework review...") and 'when' ("Triggers on mentions of..." with concrete trigger phrases), plus explicit non-triggers ("Does not apply to single-pillar deep-dives, learning WA concepts, ADRs, or migration readiness assessments"). This matches the anchor that requires both what and when with concrete trigger phrases; a 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

"Triggers on mentions of Well-Architected review, WA review, WAR, pillar assessment, architecture review across pillars, workload assessment, cloud readiness evaluation, or a Well-Architected score, grade, or scorecard request" covers natural phrasings plus abbreviations and synonyms (WA, WAR, grade, scorecard). No common user phrasing is missing, matching the synonym-inclusive anchor 5 rather than the 'a few natural terms missing' anchor 4.

5 / 5

Distinctiveness Conflict Risk

A clear AWS Well-Architected review niche with distinct triggers and an explicit exclusion list that further separates it from adjacent skills (single-pillar deep-dives, migration readiness). Minimal conflict risk — matches anchor 5; anchor 4 would imply minor overlap risk with closely related skills, which the exclusion clause mitigates.

5 / 5

Total

20

/

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
aws/agent-toolkit-for-aws
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.