speckit.database

speckit.database is a skill for Claude Code, Codex from wedabro/bro-skills. It costs 29 tokens per session (892 once invoked), scanned A, original, MIT.

A database architecture guide for designing schemas, indexes, migrations, queries, data integrity, backups, and production operations. A schema describes how data is organized and related in a database.

In plain words
What is it for?
Use it to design or review database schemas, constraints, indexes, migrations, query plans, backups, replication, connection limits, retention, and recovery requirements.
Why use it?
It helps prevent data-modeling and operational mistakes by requiring the project to consider ownership, access patterns, growth, recovery, availability, and production risk before changes are made.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to design or review database schemas, constraints, indexes, migrations, query plans, backups, replication, connection limits, retention, and recovery requirements.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/wedabro/bro-skills/speckit.database
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 wedabro/bro-skills --skill speckit.database
Clone the repo
git clone --depth 1 https://github.com/wedabro/bro-skills

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 speckit.database

README.md
[![agentmods](https://agentmods.dev/badge/skills/wedabro/bro-skills/speckit.database.svg)](https://agentmods.dev/skills/wedabro/bro-skills/speckit.database)
Your own site
<a href="https://agentmods.dev/skills/wedabro/bro-skills/speckit.database"><img src="https://agentmods.dev/badge/skills/wedabro/bro-skills/speckit.database.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 892 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.
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.00029 $0.00892
Opus 5 $0.00015 $0.00446
Sonnet 5 $0.00006 $0.00178
Haiku 4.5 $0.00003 $0.00089

Measured 8d ago against content hash 3f53806b7b36, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

speckit.database 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 8d 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.

.agents/skills/speckit.database/SKILL.md · 86 lines

How it starts

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

Mission

Design data systems that are correct, performant, recoverable, and operable. Use .agents/knowledge_base/data_schema.md, the feature plan, and the project constitution. Coordinate with speckit.backend for transaction ownership, speckit.security for sensitive data, and speckit.devops for runtime setup.

Protocol

0. Preflight

  • Identify data classification, ownership, access paths, expected growth, write/read ratio, retention, RPO, RTO, availability target, and production blast radius before choosing a schema or operation.
  • Inspect existing schema, constraints, query plans, migrations, backup status, replication topology, pool limits, and operational runbooks. State unknowns rather than treating a backup or replica as verified.

1. Schema and Integrity

  • Normalize to 3NF by default; denormalize only for a measured query or scale need and record the consistency/maintenance cost.
  • Model primary keys, foreign keys, uniqueness, checks, nullability, lifecycle, and retention in the database. Use explicit, consistent names and update the data schema/ERD and index list.
  • Select data types for semantics, range, timezone, precision, and collation; avoid unbounded JSON or text fields where a constrained model is required.
  • Define transaction boundaries, isolation, lock ordering, and conflict policy. Use parameterized queries only; prevent N+1 and unbounded reads.

2. Query and Capacity Design

  • Index proven WHERE, JOIN, ORDER BY, and tenant access patterns; order composite indexes for actual predicates. Do not add speculative indexes.
  • Validate expensive paths with representative EXPLAIN/query-plan evidence; investigate scans, hot rows, lock waits, large offsets, and write amplification.
  • Forecast storage, IOPS, connection, replica, and maintenance headroom. Set per-service pool limits and backpressure so clients cannot exhaust the DB.

3. Safe Evolution

  • Version migrations and make rollback/forward-recovery behavior explicit. Use expand → backfill in batches → dual read/write when needed → validate → contract for live data changes.
  • Assess lock behavior and runtime cost before production DDL; use online or concurrent operations where supported. Separate destructive removal into a later, explicitly approved release.
  • Back up and prove a restoration path before destructive/high-impact changes. Never run migration, backfill, delete, or index operation blindly on prod.

Read the full file on GitHub · 86 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. 8d ago First seen · 86 lines · 29 tokens per session scan A 3f53806b7b36

Subscribe to this mod's changes

speckit.database is a skill published in the GitHub repository wedabro/bro-skills (2 stars, last pushed 12d ago), licensed MIT. It adds 29 tokens to every session and 892 once invoked, about $0.0001 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

offensive-sqli

SQL injection testing skill for offensive security assessments and bug bounty hunting. Covers error-based, UNION-based, boolean/time-based blind, out-of-band, second-order, NoSQL, GraphQL, WebSocket, and JSON-operator SQLi. Includes WAF bypass techniques, database-specific exploitation (MySQL, MSSQL, PostgreSQL…

SnailSploit/Claude-Red · 117 tokens

yida-data-management

A tool for querying, adding, and updating Yida form records, child tables, process records, and task-center data. It keeps ordinary forms and approval workflows on their separate data interfaces.

openyida/openyida · 60 tokens

yida-aggregate-table

A workflow for managing Yida aggregate tables, also called virtual views. These are tables built from related form data rather than ordinary standalone records.

openyida/openyida · 71 tokens

yida-db-seq-fix

A tool for checking and correcting PostgreSQL sequences, which generate automatic numeric IDs for new rows. It is designed for Yida databases after automatic table creation or data migration.

openyida/openyida · 73 tokens

doris-repo-review

Review an Apache Doris PR from a local clone with the same multi-agent, shared-ledger convergence workflow as the CI Code Review Runner. Use when the user supplies a PR to /doris-repo-review, asks to review a Doris PR locally, or asks for the CI-style review flow. Safely align only the current worktree to the exact PR…

apache/doris-skills · 180 tokens

doris-architecture-advisor

Workload-aware architecture design for Apache Doris. MUST USE when designing data architectures, choosing between data models, planning ingestion strategies, sizing clusters, or translating business requirements into Apache Doris system designs. Complements doris-best-practices with decision frameworks and…

apache/doris-skills · 279 tokens