CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-model-creation

[Deprecated] Optional advanced tool for complex data modeling. For simple MySQL table creation, use relational-database-tool directly; for PostgreSQL / CloudBase PG schema work, use postgresql-development. New environments should use PostgreSQL DDL via queryPgDatabase/managePgDatabase — see postgresql-development skill instead.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./plugin/cloudbase/skills/data-model-creation/SKILL.md

The canonical home for this skill is data-model-creation in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The body is a well-structured, actionable guide: concrete tool calls with parameters, a complete Mermaid example, an exact type-mapping table, and validation checkpoints before the risky publish step. Its main weakness is redundancy — the same routing guidance (use relational-database-mcp-cloudbase for MySQL, postgresql-development-cloudbase for PG) is restated in four separate places — and the absence of an error-recovery loop and a full tool-call example.

Suggestions

Consolidate the MySQL/PostgreSQL handoff guidance, currently repeated in 'Then also read', 'Overview', 'Quick routing', and 'Best practices' #5, into a single routing section (the body's largest token waste).

Add one complete modifyDataModel invocation (full mermaidDiagram payload plus publish decision) so the create flow is fully copy-paste ready, and specify how enum values are defined alongside the 'x-enum' type.

Close the workflow with an explicit feedback loop, e.g. 'After manageDataModel reports the generated fields/relationships, fix any naming or direction issues in the Mermaid diagram and re-run before publishing'.

DimensionReasoningScore

Conciseness

The body is mostly efficient — no filler explaining concepts Claude already knows, and the type-mapping table and Mermaid example are dense — but the MySQL-vs-PostgreSQL routing rule is repeated four times ("Then also read", Overview bullet, the entire "Quick routing" section, and Best practices #5), which is more than the 'minor instances' of anchor 4. Matches anchor 3 ("Mostly efficient but includes some unnecessary explanation or could be tightened").

3 / 5

Actionability

Concrete, executable guidance dominates: exact tool invocations with parameters (`manageDataModel(action="list"|"get"|"docs")`, `modifyDataModel` with `action="create"` and a `mermaidDiagram`), a complete copy-paste-ready Mermaid example with required()/unique()/display_field(), and an exact type-mapping table. Not anchor 5 because a full modifyDataModel call example (complete payload) is absent and enum handling is vague ("Keep enum values human-readable when needed" gives no syntax).

4 / 5

Workflow Clarity

The "How to use this skill" section gives a clear 4-step sequence (clarify entities → model and validate → use the right tools → publish carefully) with explicit validation checkpoints ("Validate names, field types, and relationships before calling modeling tools"; "Publish only after checking field names, required constraints, and relationship directions"), matching anchor 4. Not anchor 5 because there is no error-recovery feedback loop (no 'if the generated model shows problems, revise the diagram and re-run') around the publish step, though the destructive-operation cap does not apply since validation steps are present.

4 / 5

Progressive Disclosure

The single-file skill (~175 lines) is well organized with clear sections, and all external references are one-level-deep, clearly signaled sibling skill paths with stated purposes (e.g., "Direct MySQL SQL creation -> ../relational-database-mcp-cloudbase/SKILL.md"); no bundle files exist to verify. Not anchor 5 because there is no file split at all (the Mermaid generation rules / type table are reference-style material that could live in a reference file) and the duplicated routing blocks dilute the overview's navigational clarity.

4 / 5

Total

15

/

20

Passed

Description

48%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.

The description functions primarily as a deprecation/routing notice: it is effective at steering simple MySQL and PostgreSQL work to the correct sibling skills, but it never states this skill's concrete actions (Mermaid classDiagram modeling, model creation/inspection via manageDataModel/modifyDataModel) or an explicit 'use when' trigger for itself. Its deprecation role partially justifies the routing emphasis, yet the missing own-skill trigger terms (ER diagram, Mermaid) leave it under-specified.

Suggestions

State the skill's concrete capabilities explicitly, e.g. 'Creates CloudBase data models from Mermaid classDiagram definitions, and lists/inspects existing models via manageDataModel' — currently the only concrete tool names belong to other skills.

Add an explicit trigger clause such as 'Use when the user asks for ER diagrams, Mermaid classDiagram models, or multi-entity relationship modeling' to satisfy the 'when' half of completeness and surface natural trigger terms.

Include the keywords 'ER diagram', 'Mermaid', and 'data model' so users and the agent can find this skill for diagram-driven modeling requests instead of only discovering it via its deprecation pointers.

DimensionReasoningScore

Specificity

The skill's own capability is stated only as "Optional advanced tool for complex data modeling" — a domain name with a generic action, matching anchor 2 ("Names the domain but actions are minimal or generic", cf. "Processes PDF files"). The concrete tool names present (relational-database-tool, queryPgDatabase, managePgDatabase) describe the *replacement* skills, not what this skill does (e.g., no mention of Mermaid classDiagram generation, model listing, or publishing).

2 / 5

Completeness

There is a moderate 'what' ("advanced tool for complex data modeling") and no explicit 'Use when...' clause for this skill; the 'when' is only weakly implied by negation ("For simple MySQL table creation, use relational-database-tool directly"), which caps completeness at 3 per the judging guidelines. Not anchor 2 because the 'what' is stated rather than vague, and the deprecation routing does weakly imply when the skill still applies (complex, non-simple modeling).

3 / 5

Trigger Term Quality

Relevant keywords exist ("data modeling", "MySQL table creation", "PostgreSQL", "CloudBase PG schema", "DDL"), but the natural phrases users would say when they need this skill — "ER diagram", "Mermaid", "classDiagram", "data model", "schema design" — are all absent, matching anchor 3 ("Some relevant keywords but missing common variations or synonyms"). Not anchor 4, since the core trigger vocabulary for the skill itself is missing rather than just a few terms.

3 / 5

Distinctiveness Conflict Risk

The description explicitly steers the adjacent cases away ("use relational-database-tool directly", "use postgresql-development"), giving clear boundary-setting with minor overlap risk, matching anchor 4. Not anchor 5 because the skill's own trigger ("complex data modeling") is not distinctive and lacks the Mermaid/ER-diagram terms that would give it a clear niche with distinct triggers.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

plugin/cloudbase/skills/data-model-creation/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.