dynamodb

AWS DynamoDB NoSQL database for scalable data storage. Use when designing table schemas, writing queries, configuring indexes, managing capacity, implementing single-table design, or troubleshooting performance issues.

1.00x

Quality

82%

Does it follow best practices?

Impact

93%

1.00x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Quality

Content

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid, actionable DynamoDB reference skill with excellent executable code examples covering the most common operations. Its main weaknesses are the monolithic structure (everything in one file with no progressive disclosure via bundle files) and the lack of explicit multi-step workflows with validation checkpoints, particularly for operations like batch writes where checking UnprocessedItems is critical. Some content like the introductory paragraph and basic CLI command listings add little value for Claude.

Suggestions

Add validation/verification steps to workflows: check `table.wait_until_exists()` after creation, check `UnprocessedItems` after batch operations, and verify GSI status after creation with `describe-table`.

Remove the introductory paragraph explaining what DynamoDB is and trim the CLI reference tables—Claude already knows these. This would improve conciseness significantly.

Split detailed code examples (CRUD, queries, batch ops) and troubleshooting into separate bundle files, keeping SKILL.md as a concise overview with pointers to detailed references.

Dimension	Reasoning	Score
Conciseness	The skill is reasonably well-organized but includes some unnecessary content Claude already knows (e.g., the opening description of what DynamoDB is, the CLI reference tables that are easily available in docs). The core concepts tables are borderline—useful as quick reference but also common knowledge. The code examples are appropriately detailed without excessive commentary.	2 / 3
Actionability	Excellent actionability with fully executable code examples for CRUD operations, queries, batch operations, conditional writes, table creation (both CLI and boto3), and troubleshooting solutions. All code is copy-paste ready with proper imports and error handling.	3 / 3
Workflow Clarity	The skill presents individual operations clearly but lacks explicit multi-step workflows with validation checkpoints. For example, table creation doesn't include verification steps, batch operations don't mention checking UnprocessedItems, and there's no workflow for the common pattern of designing → creating → testing a single-table design. The troubleshooting section has a good debug checklist but most sections lack feedback loops.	2 / 3
Progressive Disclosure	The content is well-structured with a table of contents and clear sections, but it's a monolithic file (~300 lines) with no bundle files to offload detailed content. The CLI reference tables, detailed code examples, and troubleshooting sections could be split into separate files. External references are provided but only as documentation links, not as structured bundle files.	2 / 3
	Total	9 / 12 Passed

Description

100%

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 a well-crafted skill description that clearly identifies the technology domain (AWS DynamoDB), states its purpose, and provides an explicit 'Use when...' clause with six specific trigger scenarios. The description uses appropriate third-person voice, includes natural keywords users would employ, and is concise without unnecessary padding.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: designing table schemas, writing queries, configuring indexes, managing capacity, implementing single-table design, and troubleshooting performance issues.	3 / 3
Completeness	Clearly answers both 'what' (AWS DynamoDB NoSQL database for scalable data storage) and 'when' with an explicit 'Use when...' clause listing six specific trigger scenarios.	3 / 3
Trigger Term Quality	Includes strong natural keywords users would say: 'DynamoDB', 'NoSQL', 'table schemas', 'queries', 'indexes', 'capacity', 'single-table design', 'performance issues'. These cover common terms a user working with DynamoDB would naturally use.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with DynamoDB-specific terminology like 'single-table design', 'NoSQL', and 'DynamoDB' itself. Unlikely to conflict with generic database skills or other AWS service skills.	3 / 3
	Total	12 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: itsmostafa/aws-agent-skills
Commit: 4ab904a

Reviewed: about 1 month 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.