Tessl • The package manager for agent skills

Blog Docs Log inGet started

SkillPublic

aws-dynamodb

AWS DynamoDB single-table design, GSI patterns, SDK v3 TypeScript/Python

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/aws-dynamodb/SKILL.md

Quality

Content

65%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 highly actionable with complete, executable code in both languages, but it is a monolithic 660-line reference that explains DynamoDB basics Claude already knows and provides no validation or error-recovery guidance for its batch and destructive operations. Splitting language-specific and CLI reference material into bundle files and adding a concepts-trimming pass would lift the weaker dimensions.

Suggestions

Move the Python/boto3 section, CLI Quick Reference, and GSI pattern catalog into references/ files linked from a lean SKILL.md overview.

Add validation/feedback loops for batch and destructive operations, e.g. handling UnprocessedItems retries in BatchWrite and verifying TransactWrite condition failures.

Cut content Claude already knows: the DynamoDB intro paragraph, the Key Concepts table defining PK/SK/Item, and package-install instructions.

Dimension	Reasoning	Score
Conciseness	The body includes content Claude already knows ('DynamoDB is a fully managed NoSQL database designed for single-digit millisecond performance', a Key Concepts table defining Partition Key/Sort Key/Item, and npm/boto3 install instructions) and duplicates near-identical CRUD boilerplate across TypeScript and Python sections. Mostly efficient with genuinely valuable pattern content, but clearly could be tightened — fits anchor 3 rather than anchor 2 since much of the material is skill-specific rather than padded.	3 / 5
Actionability	Full executable TypeScript and Python code for CRUD, pagination, batch chunking (25-item loop), transactions, and atomic counters, plus copy-paste CLI and docker commands. Code covers the common cases and is copy-paste ready, matching anchor 5 exactly.	5 / 5
Workflow Clarity	The design sequence (access patterns first, then key schema, then examples) is present, but the skill includes batch operations (BatchWriteCommand/BatchGetCommand) and destructive operations (delete, TransactWrite) with no validation steps or feedback loops — no UnprocessedItems handling, no error-recovery guidance. Per the rubric guideline, missing validation in batch/destructive operations caps workflow clarity at 3 even though the sequence itself is clear.	3 / 5
Progressive Disclosure	No bundle files exist (references/, scripts/, assets/ are absent) and the entire ~660-line body is inline, including content that clearly belongs in separate files (CLI Quick Reference, the Python section, GSI pattern catalog). Section headers are clear and well-organized, so this fits anchor 3 ('some structure... content that should be separate is inline') rather than anchor 2's minimal structure.	3 / 5
	Total	14 / 20 Passed

Description

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

The description is specific and clearly scoped to the DynamoDB niche with good natural keywords, but it lacks any 'Use when...' trigger clause, which both caps completeness and leaves activation guidance implicit. Adding an explicit when-to-use clause with a few more synonyms (NoSQL, boto3) would round it out.

Suggestions

Append an explicit trigger clause, e.g. 'Use when working with DynamoDB tables, NoSQL data modeling, or boto3 / AWS SDK data operations.'

Include common user synonyms such as 'NoSQL', 'boto3', and 'AWS database' to broaden natural trigger coverage.

Frame capabilities as actions (e.g. 'Design single-table schemas, model GSI access patterns, implement SDK v3 operations') rather than bare topic labels.

Dimension	Reasoning	Score
Specificity	Names several concrete capabilities ('single-table design, GSI patterns, SDK v3 TypeScript/Python'), though framed as topic labels rather than actions and missing areas like capacity planning or migrations. Fits anchor 4 (several specific items, minor gaps) rather than 5 (not comprehensive) or 3 (more than 1-2 concrete items listed).	4 / 5
Completeness	The 'what' is clear (single-table design, GSI patterns, SDK v3 usage) but the description contains no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This matches anchor 3 (clear 'what', 'when' missing) rather than anchor 4 which requires both.	3 / 5
Trigger Term Quality	'DynamoDB', 'single-table', 'GSI', and 'SDK v3' are natural terms users would say when needing this skill, but common synonyms like 'NoSQL', 'boto3', and 'AWS database' are missing. Good keyword coverage with a few natural terms absent fits anchor 4, not the comprehensive synonym coverage of anchor 5.	4 / 5
Distinctiveness Conflict Risk	'AWS DynamoDB single-table design, GSI patterns, SDK v3' occupies a clear niche with distinct triggers (DynamoDB-specific terminology) and minimal conflict risk with other skills. Matches anchor 5; no neighboring anchor fits better since the domain is unambiguously scoped.	5 / 5
	Total	16 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (670 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: alinaqi/maggy
Path: skills/aws-dynamodb/SKILL.md
Revision: 55aabe2

Reviewed: 26 days ago

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.

aws-dynamodb

Table of Contents

Is this your skill?