Dynamodb Toolbox Patterns

If you're building TypeScript services on DynamoDB and want strict type safety without fighting the SDK, this gives you working patterns for DynamoDB-Toolbox v2. It covers the full `.build()` command workflow for CRUD, query and scan access patterns with GSIs, batch and transaction operations, and single-table design with computed keys. The examples show real schema modeling with transforms, defaults, and complex attributes like maps and lists. Most useful when you're past the proof-of-concept stage and need production patterns that keep your keys consistent and your access patterns explicit. Includes guidance on avoiding common pitfalls like table scans in request paths and misusing transactions.

skills.sh installs: 3.6K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill dynamodb-toolbox-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

DynamoDB-Toolbox v2 Patterns (TypeScript)

Overview

This skill provides practical TypeScript patterns for using DynamoDB-Toolbox v2 with AWS SDK v3 DocumentClient. It focuses on type-safe schema modeling, .build() command usage, and production-ready single-table design.

When to Use

Defining DynamoDB tables and entities with strict TypeScript inference
Modeling schemas with item, string, number, list, set, map, and record
Implementing GetItem, PutItem, UpdateItem, DeleteItem via .build()
Building query and scan access paths with primary keys and GSIs
Handling batch and transactional operations
Designing single-table systems with computed keys and entity patterns