reviewing-data-model

Reviews finished data-model documents against a nine-condition integrity and queryability bar, emitting an approve or revise verdict.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill reviewing-data-model-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-data-model
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-data-model
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-data-model-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams need an independent acceptance gate that decides whether a finished data-model document is complete enough for an engineer to build the schema and write correct queries from it, without the reviewer silently rewriting the model or approving it on completeness alone. ## Core Features & Use Cases - Nine-condition review bar: Judges entities and keys, relationship cardinality and referential rules, access-pattern-justified indexes, normalization and paradigm choice, lifecycle and migration, diagram-to-table sync, privacy and scale, groundedness, and delta-scoped amends. - Paradigm-aware judgment: Evaluates relational, document, graph, wide-column, and key-value models in their own idiom instead of demanding normalization or foreign keys from NoSQL designs. - Machine-parseable verdict: Emits exactly VERDICT: approve or VERDICT: revise plus actionable findings naming the failed condition, location, and fix. - Use Case: After authoring a data model for a new orders service, run this reviewer before schema implementation; it flags a missing on-delete rule and an unjustified index, returning findings the author resolves in one revision pass. ## Quick Start Use reviewing-data-model on the finished data-model document at docs/specs/orders-data-model.md and return the verdict with findings.

Frequently Asked Questions about reviewing-data-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a data model document before schema implementation?

Hand the finished data-model document to this reviewer, which judges it against nine conditions covering entities, relationships, indexes, normalization, lifecycle, and consistency. It returns a VERDICT approve or revise line plus actionable findings the author can fix in one pass.

What does the data model review checklist check?

The checklist covers typed and keyed entities, relationship cardinality with referential rules, access-pattern-justified indexes, normalization and paradigm rationale, lifecycle and migration plans, diagram-to-table sync, privacy and scale, groundedness, and delta-scoped amend quality.

Does this reviewer work for NoSQL or graph data models?

Yes, it is paradigm-aware and judges document, graph, wide-column, and key-value models in their own idiom. It evaluates embed-vs-reference, edges, or partition keys instead of demanding normal forms or foreign keys from non-relational designs.

When should I not use this data model reviewer?

Do not use it to author or repair a model, to review api-specs or feature-specs, to review ORM or migration code, or for generic design docs and RFCs. Use authoring-data-model for writing and design-review for generic engineering documents.

How does the reviewer handle an amended data model?

Amendments are reviewed delta-scoped: only the changed entities, their migration plan, and the downstream ripple are judged. It checks additive-versus-breaking classification, expand-and-contract migration, and changelog presence without re-reviewing the unchanged model.