CtrlK
BlogDocsLog inGet started
Tessl Logo

aws-blocks

Guides building full-stack applications with AWS Blocks — an Infrastructure-from-Code framework. Applies when creating APIs, selecting Building Blocks (KVStore, DistributedTable, Database, AuthBasic, AuthCognito, Realtime, AsyncJob, FileBucket, etc.), running local development, or deploying AWS Blocks applications. Also covers AWS Blocks topics with validated, version-specific patterns that prevent common mistakes. Triggers when user mentions AWS Blocks; project has aws-blocks/ directory; code imports @aws-blocks packages.

68

Quality

81%

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

The canonical home for this skill is aws-blocks in aws/agent-toolkit-for-aws

SKILL.md
Quality
Evals
Security

Quality

Content

68%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-organized overview skill that is appropriately concise and gives concrete, executable scaffolding commands and security directives, while correctly deferring deep API detail to the installed packages' authoritative READMEs. The main gap is workflow clarity: the develop/deploy sequence is only implied and lacks any inline summary or validation checkpoints, and there is no minimal code example for the most common task (defining an API method with a Block).

Suggestions

Add a short inline 3-5 step development workflow (scaffold -> define ApiNamespace methods with Blocks -> npm run sandbox -> verify locally -> npm run deploy) with an explicit validation checkpoint before deploy, instead of delegating the whole workflow to the external README.

Include one minimal copy-paste example of defining an API method that uses a Building Block (e.g., a KVStore-backed method with requireAuth and a Zod schema), since that is the skill's most common task.

Trim redundancy: collapse the Overview prose and 'Key characteristics' bullets into one section, and merge the 'existing project' and 'Amplify Gen 2' subsections that show the identical command.

DimensionReasoningScore

Conciseness

The body is mostly lean: scaffolding commands are bare bash blocks, the templates table is dense reference material, and the security section is a compact actionable bullet list. Minor over-explanation remains — the Overview's prose ('AWS Blocks is an Infrastructure-from-Code framework where Building Blocks bundle CDK, SDK, and local mocks') partially repeats the 'Key characteristics' bullets, and the Amplify subsection restates the same command already shown for existing projects.

4 / 5

Actionability

Mostly executable guidance: copy-paste-ready commands ('npx @aws-blocks/create-blocks-app my-app --template demo'), a concrete template table, and specific API directives ('await auth.requireAuth(context)', 'new AppSetting(scope, id, { secret: true })', 'crossDomain: true'). Not a 5 because the core development workflow is delegated wholesale to node_modules READMEs with no inline minimal example (e.g., defining an ApiNamespace method or wiring a Block), leaving a gap for the most common task.

4 / 5

Workflow Clarity

Scaffolding steps are clear and sequenced, but the actual develop-then-deploy workflow is only implied ('Deploy ephemeral... with npm run sandbox and long-lived environments with npm run deploy') and the Development Workflow section defers to an external README without summarizing the sequence. There are no validation checkpoints (e.g., verifying a sandbox build or checking deployed stack status) before deploying, which per the rubric caps this dimension at 3.

3 / 5

Progressive Disclosure

Good structure with well-organized sections and clearly signaled, one-level-deep pointers to authoritative external docs ('refer to node_modules/@aws-blocks/blocks/README.md', 'read its package README... e.g., node_modules/@aws-blocks/bb-kv-store/README.md') — no nested reference chains. Not a 5: the body runs ~85 lines with a fairly detailed inline Security Considerations section that could live in a reference file, and no bundle files of its own are provided.

4 / 5

Total

15

/

20

Passed

Description

95%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 third-person description that clearly states both what the skill does and when to use it, with concrete named Building Blocks and precise trigger conditions tied to the framework name, its directory, and its package imports. The only weakness is one vague closing sentence about 'validated, version-specific patterns' that pads without adding a concrete capability.

Suggestions

Replace the vague closing sentence ('Also covers AWS Blocks topics with validated, version-specific patterns that prevent common mistakes') with a concrete capability, e.g. 'Applies security best practices such as requireAuth, secret AppSettings, and least-privilege IAM'.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'creating APIs, selecting Building Blocks (KVStore, DistributedTable, Database, AuthBasic, AuthCognito, Realtime, AsyncJob, FileBucket, etc.), running local development, or deploying AWS Blocks applications' — with named block types. Falls short of a 5 because the trailing sentence 'Also covers AWS Blocks topics with validated, version-specific patterns that prevent common mistakes' is vague fluff that adds no concrete capability.

4 / 5

Completeness

Explicitly answers both questions: what ('Guides building full-stack applications with AWS Blocks — an Infrastructure-from-Code framework... building CDK, SDK... local development... deploying') and when, via both an 'Applies when' clause and a dedicated 'Triggers when' clause with concrete trigger conditions. Clearly matches the 5 anchor; no missing when-guidance that would cap it at 3.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage: 'user mentions AWS Blocks; project has aws-blocks/ directory; code imports @aws-blocks packages', plus concrete when-clauses ('creating APIs', 'running local development', 'deploying'). These are exactly the phrases and artifacts a user working with this framework would produce, matching the anchor's synonym-and-extension-level coverage.

5 / 5

Distinctiveness Conflict Risk

A named niche framework ('AWS Blocks') with distinct triggers — the framework name, the 'aws-blocks/' directory, and '@aws-blocks' package imports — that no other skill would claim. Minimal conflict risk; clearly fits the 'clear niche with distinct triggers' anchor rather than the 4 anchor's 'minor overlap risk'.

5 / 5

Total

19

/

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.