CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

entity-model

Creates entity model documents with Mermaid.js ER diagrams and attribute tables defining entities, relationships, data types, and validation rules. Use when the user asks to "create an entity model", "design a data model", "draw an ERD", "define database schema", "model entities", or mentions entity-relationship diagram, ER diagram, database design, or data modeling. Also trigger whenever the task is to produce, write, or design an entity model or data model document (e.g. docs/entity_model.md) from a requirements catalog — including phrasings like "data model design", "the team needs an entity model before development", or a request to document entities with attributes, data types, precision, and validation or cross-attribute constraints.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is ai-unified-process/aiup-core

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable instruction skill: exact output formats, closed vocabularies, a worked example, and a workflow with an unusually thorough validation checklist. The main weakness is token efficiency — the validation vocabulary tables are duplicated between SKILL.md and references/REFERENCE.md, and two overlapping rule tables could be consolidated.

Suggestions

Keep the Validation Rules vocabulary in only one place: either trim the inline Keys/Position/mapping tables in SKILL.md to a brief summary and rely on references/REFERENCE.md, or drop the duplicate from the reference file.

Consolidate the Position table and the attribute-type-to-value mapping table (they encode the same rules twice); the worked example cells already demonstrate composition.

Make the validation feedback loop explicit in step 6, e.g. "If any check fails, fix the document and re-run all checks before reporting" — currently the fix-and-retry loop is only implicit.

DimensionReasoningScore

Conciseness

The body is prescriptive throughout (closed vocabularies, exact formats, anti-pattern examples) and explains nothing Claude already knows, but it carries the full Validation Rules tables inline ("Keys", the Position table, and the attribute-type mapping table) while stating "The same tables are available in [references/REFERENCE.md]" — roughly 40 lines duplicated across SKILL.md and the reference file, and the Position table overlaps the subsequent attribute-type mapping table. Not a 4 because the duplication is more than a minor trim; not a 2 because most of the text is genuinely load-bearing rules that earn their tokens.

3 / 5

Actionability

Everything is executable and copy-paste ready for an instruction skill: exact heading format ("A ### heading with the entity name in UPPERCASE (UPPER_SNAKE_CASE ... never `### Room Type`"), an exact 5-column table spec, a closed Data Types list, a closed Validation Rules vocabulary with worked example cells ("Not Null, Values: Pending, Active, Completed, Cancelled"), concrete Mermaid syntax, and a filled example entity table. Not a 4 because the common cases are covered completely with explicit negative examples.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced with an explicit clarification step (including fallback behavior when no one can answer), TodoWrite task breakdown, per-entity sub-steps, and a 12-item validation checklist in step 6 before reporting. Not a 4 because validation checkpoints are explicit and exhaustive; the only nit is that "fix and re-validate" after a failed check is implicit rather than stated.

5 / 5

Progressive Disclosure

Two clearly-signaled, one-level-deep references ([references/REFERENCE.md] and [references/clarify-checklist.md] in workflow step 2) exist in the bundle and are correctly linked, and sections are well organized. Not a 5 because the Validation Rules content is inlined in SKILL.md while also living in REFERENCE.md — the same content occupies two places, a minor organization gap; not a 3 because navigation is easy and no content that clearly belongs elsewhere is buried.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete third-person statement of what the skill produces, followed by an explicit and broad "Use when" clause with many natural trigger phrasings, synonyms, and abbreviations. Both the "what" and "when" are answered explicitly and specifically, with essentially no vague or padded language.

DimensionReasoningScore

Specificity

"Creates entity model documents with Mermaid.js ER diagrams and attribute tables defining entities, relationships, data types, and validation rules" names multiple concrete deliverables and their contents comprehensively; nothing is vague or generic. Not a 4 because coverage of what the skill produces (diagrams, tables, types, validation rules) is complete rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: "what" (creates entity model documents with Mermaid.js ER diagrams and attribute tables) and "when" ("Use when the user asks to ... or mentions entity-relationship diagram, ER diagram, database design, or data modeling", extended by an "Also trigger whenever" clause with further concrete phrasings). Written in third person ("Creates"). Not a 4 because the "when" is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

The description covers natural phrasings users would actually say — "create an entity model", "design a data model", "draw an ERD", "define database schema", "model entities" — plus synonyms and abbreviations (entity-relationship diagram, ER diagram, ERD, database design, data modeling, data model design) and a concrete file path (docs/entity_model.md). Not a 4 because even less-common trigger variants (e.g. "the team needs an entity model before development") are explicitly included.

5 / 5

Distinctiveness Conflict Risk

The trigger cluster (entity model, ERD, entity-relationship diagram, data modeling document from a requirements catalog) is a clear niche with distinct triggers; the description scopes the skill to producing an entity model document rather than implementing a database, minimizing overlap with schema-implementation or migration skills. Not a 4 because no closely related skill's triggers are subsumed in a way that would realistically cause a wrong trigger.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

AI-Unified-Process/marketplace

Path

aiup-core/skills/entity-model/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.