CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-dynamodb-best-practices

AWS DynamoDB best practices for table design and data modeling. Use when designing DynamoDB schemas, choosing partition/sort keys, creating secondary indexes, modeling relationships, handling time series data, or optimizing query patterns. Triggers on tasks involving DynamoDB table creation, key design, GSI/LSI configuration, single-table design, adjacency lists, write sharding, or capacity planning. Does not cover DynamoDB SDK/API reference or CloudFormation/Terraform resource definitions.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 lean, opinionated overview with concrete verdict tables and thresholds, backed by five well-signaled, one-level-deep reference files that verifiably contain the promised detail. The only structural gap is the absence of an explicit ordered design workflow with checkpoints — sequence is implied by section order and the Common Mistakes table rather than enumerated.

DimensionReasoningScore

Conciseness

Every section delivers opinionated, non-generic guidance in dense tables and short examples — partition-key verdicts, GSI-vs-LSI conditions, TransactWriteItems limits (100 items / 4 MB / 2x WCU), the ~100 KB S3-offload threshold. There is no explanation of concepts Claude already knows and no padding, matching the 'every token earns its place' anchor.

5 / 5

Actionability

For an instruction/design skill, the guidance is maximally concrete: concrete PK/SK examples with query predicates, decision rules with exact thresholds, per-scenario approach tables, and a Common Mistakes table mapping each mistake to a specific fix. The only thin spot (the adjacency-list section defers examples to the reference file) is a deliberate progressive-disclosure split, not a missing key detail.

5 / 5

Workflow Clarity

The design process is well ordered — 'Identify all access patterns before creating tables' is an explicit sequencing directive, sections follow the natural design order (access patterns → keys/indexes → modeling → concurrency → global tables), and the Common Mistakes table doubles as a corrective checklist. It falls short of a 5 because there is no explicit step-by-step design procedure or checkpoint-style verification list; the sequence is implied by section order rather than enumerated. No destructive/batch-operation cap applies.

4 / 5

Progressive Disclosure

The ~105-line body is a true overview: each topic section is a digestible summary with a clearly signaled 'See references/X.md for...' pointer, and a consolidated Reference Files section lists all five one-level-deep files with accurate descriptions. All five referenced files exist (spot-checked key-and-index-design.md, whose contents match the pointer's summary), and no reference nests deeper than one level.

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.

The description is an exemplar: it states a specific capability set, provides explicit 'Use when'/'Triggers on' clauses with natural domain vocabulary, and closes with scope exclusions that prevent mis-triggering. No changes needed.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'designing DynamoDB schemas, choosing partition/sort keys, creating secondary indexes, modeling relationships, handling time series data, or optimizing query patterns' — with comprehensive coverage of the table-design domain. It matches the anchor-5 example's breadth without padding, and is not a level-4 case since there is no noticeable coverage gap in the skill's stated scope.

5 / 5

Completeness

Explicitly answers both: what ('AWS DynamoDB best practices for table design and data modeling') and when ('Use when designing DynamoDB schemas... Triggers on tasks involving...'). It mirrors the anchor-5 example structure and additionally adds negative boundary guidance ('Does not cover DynamoDB SDK/API reference or CloudFormation/Terraform resource definitions'), which a level-4 description would lack.

5 / 5

Trigger Term Quality

Natural trigger vocabulary a DynamoDB user would actually say is comprehensively covered: 'DynamoDB schemas', 'partition/sort keys', 'secondary indexes', 'GSI/LSI', 'single-table design', 'adjacency lists', 'write sharding', 'capacity planning'. The anchor-4 case ('a few natural terms missing') fits worse; legacy synonyms like 'hash/range key' are the only omissions and the modern canonical terms are all present.

5 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers — every trigger is DynamoDB-specific, and the explicit exclusions of SDK/API reference and CloudFormation/Terraform definitions sharply reduce overlap with general AWS or IaC skills. It is a clean fit for the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

provectus/awos-recruitment

Path

registry/skills/aws-dynamodb-best-practices/SKILL.md

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.