CtrlK
BlogDocsLog inGet started
Tessl Logo

aws-amplify

Build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first). Covers auth (Cognito), data (AppSync/DynamoDB), storage (S3), functions, APIs, and AI (Amplify AI Kit with Bedrock). Supports React, Next.js, Vue, Angular, React Native, Flutter, Swift, and Android. Always use this skill for Amplify Gen2 topics — even for questions you think you know — it contains validated, version-specific patterns that prevent common mistakes. TRIGGER when: user mentions Amplify Gen2; project has amplify/ directory or amplify_outputs; code imports @aws-amplify packages; user asks about defineBackend, defineAuth, defineData, defineStorage, defineFunction, or npx ampx. SKIP: Amplify Gen1 (amplify CLI v6), standalone SAM/CDK without Amplify (use aws-serverless), direct Bedrock without Amplify AI Kit (use bedrock).

88

1.50x
Quality

87%

Does it follow best practices?

Impact

83%

1.50x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a strong, highly actionable routing document with real, verified reference files and excellent trigger-based navigation. Its main weaknesses are token-level duplication (identical configure snippets repeated per framework) and a somewhat long, occasionally muddled Next.js/Framework Setup section that partially belongs in a separate reference.

Suggestions

Collapse the duplicate Amplify.configure snippets: present the shared 3-line snippet once (React/Vue/Angular) and the shared React Native snippet once, listing only the differing entry-point file paths per framework.

Restructure the Next.js SSR section — the '{ ssr: true }' blockquote at the top of the Next.js content describes App/Pages Router differences before either subsection appears; move it after the App Router example or merge it into a single comparison table.

Move the SvelteKit, Astro, and Unsupported Frameworks configuration details into a framework-setup reference file (e.g., references/framework-setup.md), keeping only the routing table and the most common React/Next.js patterns in SKILL.md.

DimensionReasoningScore

Conciseness

The bulk is high-value, Amplify-specific knowledge Claude would not know (pitfalls like import order for react-native-get-random-values, the App Router client-component pattern), but there is real duplication: the identical three-line Amplify.configure snippet is repeated verbatim for React, Vue, and Angular, and again identically for Expo and bare React Native. The Next.js section is also structurally muddled — the `{ ssr: true }` guidance blockquote appears before the App Router subsection it belongs to. This fits anchor 3 ('could be tightened') better than anchor 4, where over-explanation is only minor.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: install commands ("npm install aws-amplify @aws-amplify/react-native ..."), complete working code for each framework's entry point, a full ConfigureAmplifyClientSide component, the Astro client:only example, verification commands ("aws sts get-caller-identity", "npx ampx --version"), and a concrete directory layout. Common cases across all supported frameworks are covered.

5 / 5

Workflow Clarity

The Quick Start gives a clear routed sequence (identify task type → backend feature → frontend integration), Gen2 detection has explicit if/then branching with a stop condition ("If amplify/.config/ exists instead, this is a Gen1 project — do not proceed"), and prerequisites double as validation checkpoints. It falls short of anchor 5 because there is no post-implementation verification loop (e.g., confirming sandbox is healthy or the frontend compiles after configuration) — those checkpoints are deferred to references rather than stated inline.

4 / 5

Progressive Disclosure

All 14 referenced files exist in references/ and are one level deep, well signaled by routing tables with explicit 'When to Use' columns and a 'Load only what you need' directive. However, the ~200-line Framework Setup section (per-framework entry-point snippets, SvelteKit, Astro, unsupported frameworks) is inline content that would fit a dedicated framework-setup reference, matching anchor 4's 'most content is appropriately placed; minor organization gaps' rather than the 5 anchor's fully appropriate split.

4 / 5

Total

16

/

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.

This is an exemplary description: it states concrete capabilities with named AWS services, provides comprehensive and natural trigger terms (including the define* API names and npx ampx), and includes explicit what/when guidance with a SKIP clause that disambiguates Gen1, SAM/CDK, and raw Bedrock. No significant weaknesses found.

DimensionReasoningScore

Specificity

The description names concrete actions ("Build and deploy full-stack web and mobile apps") and comprehensively enumerates the capability surface with specific services: "auth (Cognito), data (AppSync/DynamoDB), storage (S3), functions, APIs, and AI (Amplify AI Kit with Bedrock)". Coverage of the Amplify Gen2 domain is comprehensive with named AWS services, matching the top anchor rather than anchor 4's 'minor gaps in coverage'.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via the build/deploy action and feature coverage, and 'when' via a dedicated TRIGGER clause with concrete trigger phrases plus an explicit "Always use this skill for Amplify Gen2 topics" directive. This mirrors the 5 anchor's 'concrete trigger phrases' and exceeds the 4 anchor where 'when' is less specific.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and natural: "user mentions Amplify Gen2", "project has amplify/ directory or amplify_outputs", "code imports @aws-amplify packages", and API names users actually cite ("defineBackend, defineAuth, defineData, defineStorage, defineFunction, or npx ampx"), plus all eight framework names. This covers the API-level synonyms and file markers a user or codebase would naturally surface, fitting the 5 anchor.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (Amplify Gen2, TypeScript code-first) and a SKIP clause explicitly disambiguates near neighbors: "Amplify Gen1 (amplify CLI v6)", "standalone SAM/CDK without Amplify (use aws-serverless)", "direct Bedrock without Amplify AI Kit (use bedrock)". Conflict risk with adjacent AWS skills is explicitly managed, matching the 5 anchor's 'distinct triggers; minimal conflict risk'.

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.