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

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex; mentions OpenCode.

Good fit Designing DynamoDB single-table schemas, MongoDB embedding or referencing choices, consistency settings, and capacity plans.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/soulcodex/agentic/nosql-database-design
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.

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/github.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/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for nosql-database-design

Your own site · 80×15
<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="Reviewed on agentmods" width="80" 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. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.1 $0.00071 $0.01306
Opus 5.5 $0.00028 $0.00522
Sonnet 5.5 $0.00014 $0.00261
Haiku 4.5 $0.00007 $0.00131

Measured 1mo ago against content hash 739bb9dfea68, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 1mo 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. 1mo 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 1mo ago), licensed MIT. It adds 71 tokens to every session and 1,306 once invoked, about $0.0003 per session on Opus 5.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-connections

Connect a Mendix app to an external database over JDBC with the External Database Connector, and define the queries microflows run against it. Use when the app must read or write Oracle, PostgreSQL, MySQL or SQL Server directly from a microflow.

mendixlabs/mxcli · 55 tokens

connect-rapidminer-graph

Fetch data from a RapidMiner graph mart or any SPARQL 1.1 HTTP endpoint (AnzoGraph and friends) and surface it as Mendix entities. Use when a graph database with a SPARQL endpoint has to feed a Mendix app read-only.

mendixlabs/mxcli · 62 tokens

mendix-odata-pushdown

Push OData query options into the SQL of a Mendix resource served by a read microflow, so $filter, $orderby, $top, $skip, $count and the key lookup reach the database instead of being silently dropped. Use when publishing an OData resource over data Mendix has no table for — a warehouse view, a legacy database, a…

mendixlabs/mxcli · 117 tokens

generate-domain-model

Generate a complete Mendix domain model in MDL — entities, attributes, associations, enumerations — and validate it. Use when asked for a domain model for a business area (e-commerce, HR, CRM, …) rather than a single entity.

mendixlabs/mxcli · 55 tokens