nosql-database-design

nosql-database-design is a skill for Claude Code, Codex from soulcodex/agentic. It costs 71 tokens per session (1,306 once invoked), scanned A, original, MIT.

A guide for designing NoSQL databases, including DynamoDB and MongoDB data models. NoSQL databases store data without relying on traditional table relationships in the same way as relational databases.

In plain words
What is it for?
Designing DynamoDB single-table schemas, MongoDB embedding or referencing choices, consistency settings, and capacity plans.
Why use it?
It starts with the queries an application must support, helping avoid a data model that is difficult or expensive to use.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/soulcodex/agentic/nosql-database-design
Any agent
npx skills add soulcodex/agentic --skill nosql-database-design
Clone the repo
git clone --depth 1 https://github.com/soulcodex/agentic

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nosql-database-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/soulcodex/agentic/nosql-database-design.svg)](https://agentmods.dev/skills/soulcodex/agentic/nosql-database-design)
Your own site
<a href="https://agentmods.dev/skills/soulcodex/agentic/nosql-database-design"><img src="https://agentmods.dev/badge/skills/soulcodex/agentic/nosql-database-design.svg" alt="Measured on agentmods" height="20"></a>
Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,306 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00071 $0.01306
Opus 5 $0.00036 $0.00653
Sonnet 5 $0.00014 $0.00261
Haiku 4.5 $0.00007 $0.00131

Measured 4d ago against content hash 739bb9dfea68, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

nosql-database-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/backend/nosql-database-design/SKILL.md · 147 lines

How it starts

The opening of the file, as written. The whole thing — 147 lines — stays where its author put it; the contents beside it link to each section on GitHub.

NoSQL Database Design Skill

Step 1 — Access Pattern Analysis

List every query the application must answer before touching the schema. NoSQL schemas are derived from access patterns, not from entity relationships.

Access patterns for an e-commerce system:
1. Get order by order_id
2. List all orders for a user (paginated, newest first)
3. List all orders with status=PENDING (for fulfillment worker)
4. Get all line items for an order
5. Get product by product_id
6. List products by category

Identify for each pattern:

  • Query type: GetItem (by exact key) or Query (by key + filter)
  • Cardinality: how many results (1, tens, millions?)
  • Sort order: unsorted, by date, by score?
  • Filter: additional attributes to filter on after key lookup?

Step 2 — Choose the Model

Factor DynamoDB MongoDB
Access patterns Known and stable Flexible / evolving
Scale 10 B+ items, unlimited throughput Moderate to high scale
Joins Not supported — model for single-table $lookup supported (avoid in hot paths)
Transactions Supported (2-phase, up to 100 items) Multi-document transactions supported
Consistency Eventually consistent reads by default (strongly consistent optional) Tunable read/write concern

Step 3 — DynamoDB: Single-Table Design

Use a single table with a generic PK and SK:

Table: ecommerce
PK (partition key)     SK (sort key)            Attributes
─────────────────────  ─────────────────────────  ──────────────────────────
USER#u-123             PROFILE                    name, email, created_at
USER#u-123             ORDER#o-456               status, total, placed_at
USER#u-123             ORDER#o-789               status, total, placed_at
ORDER#o-456            ITEM#p-001                quantity, unit_price
ORDER#o-456            ITEM#p-002                quantity, unit_price
PRODUCT#p-001          METADATA                  name, price, category

GSI (Global Secondary Index) for access patterns that don't fit the base key:

Read the full file on GitHub · 147 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 147 lines · 71 tokens per session scan A 739bb9dfea68

Subscribe to this mod's changes

nosql-database-design is a skill published in the GitHub repository soulcodex/agentic (10 stars, last pushed 4d ago), licensed MIT. It adds 71 tokens to every session and 1,306 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

mongodb

Use when modeling MongoDB documents (embed versus reference, the 16MB cap, bucket and subset patterns), choosing or fixing indexes (compound order by the ESR rule, partial, TTL, multikey, reading explain), writing aggregation pipelines that stay index-eligible, running multi-document transactions with retry, or…

ericrisco/rsc-harness · 118 tokens

dynamodb

Use when modeling or operating a DynamoDB table: deriving partition/sort keys from access patterns, single-table vs table-per-entity, adding a GSI/LSI, on-demand vs provisioned capacity, or diagnosing hot-partition throttling. NOT relational schema/SQL/EXPLAIN (that is postgresdb), NOT aggregation-pipeline document…

ericrisco/rsc-harness · 82 tokens

database-expert

Advanced database design and administration for PostgreSQL, MongoDB, and Redis. Use when designing schemas, optimizing queries, managing database performance, or implementing data patterns.

travisjneuman/.claude · 36 tokens

data-nosql-database

Use this skill when asked about MongoDB, Cassandra, DynamoDB, Couchbase, CosmosDB, NoSQL, document database, wide-column, key-value, consistency model, CAP theorem, sharding, or denormalization. This skill enforces: NoSQL type selection (document, key-value, wide-column, graph), MongoDB aggregation pipeline and…

j4flmao/agent-skills · 140 tokens

mongodb

MongoDB - NoSQL document database with flexible schema design, aggregation pipelines, indexing strategies, and Spring Data integration.

bobmatnyc/claude-mpm-skills · 24 tokens

chrome-ext-storage

This skill should be used when working with data storage in Chrome extensions or when the user asks about extension storage patterns. Trigger when: "chrome.storage", "extension storage", "storage.local", "storage.sync", "storage.session", "IndexedDB in extension", "extension data persistence", "write-through cache"…

RadOrigin-LLC/RAD-Claude-Skills · 106 tokens