CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-modeling-skill

Design, review, and refactor Neo4j graph data models. Use when choosing node labels vs relationship types vs properties, migrating relational/document schemas to graph, detecting anti-patterns (generic labels, supernodes, missing constraints), designing intermediate nodes for n-ary relationships, enforcing schema with constraints and indexes, or assessing an existing model against graph modeling best practices. Does NOT handle Cypher query authoring — use neo4j-cypher-skill. Does NOT handle Spring Data Neo4j entity mapping — use neo4j-spring-data-skill. Does NOT handle GraphQL type definitions — use neo4j-graphql-skill. Does NOT handle data import — use neo4j-import-skill.

Quality

97%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 an exceptionally dense, executable reference: every rule is paired with concrete Cypher, decision tables replace prose, and validation checkpoints (inspect-first, poll-until-ONLINE, confirm-before-write, severity-driven actions) cover the risky database operations. The only structural weakness is that all detail lives inline in a single long file with external-only references rather than a split bundle.

Suggestions

Move the Schema Enforcement DDL catalog and the Relational→Graph migration table into a reference file (e.g. references/ddl-catalog.md) referenced one level deep, keeping only the most common statements inline in SKILL.md.

Consider extracting the supernode mitigation strategies and bucket pattern into their own reference file, signaled from a short summary in the Key Patterns section.

DimensionReasoningScore

Conciseness

The body is dense decision tables, executable Cypher, and rules with zero explanation of concepts Claude already knows — e.g. "Nodes = entities (nouns) with identity; rels = connections (verbs) with direction" and the two-line bucket pattern example. Every section carries non-obvious domain guidance; matches the lean/efficient anchor, not the 4 anchor (which requires identifiable over-explanation to trim).

5 / 5

Actionability

Guidance is copy-paste ready throughout: inspection queries ("CALL db.schema.visualization()..."), supernode detection ("count{ (n)--() } AS degree ORDER BY degree DESC LIMIT 10"), full DDL catalog ("CREATE CONSTRAINT person_id_unique IF NOT EXISTS FOR (p:Person) REQUIRE p.id IS UNIQUE"), and a concrete output-format template with severity semantics. Matches the fully-executable anchor.

5 / 5

Workflow Clarity

The workflow has explicit sequencing and validation checkpoints: "run first — never propose changes without current state", "poll until ONLINE" with the exact SHOW INDEXES query and "Do NOT use an index until state = ONLINE", "show + confirm first" for write-cypher, and a severity table mapping ERROR/WARNING/INFO to required actions, plus a final checklist. Feedback loops are present for the database operations context where the rubric demands them.

5 / 5

Progressive Disclosure

Good structure: well-organized sections, a clearly signaled one-level "References — Load on demand" list with no nested references, and an MCP tool map. However it is a ~370-line monolithic file with no bundle files — the DDL catalog, migration table, and supernode mitigation material could plausibly live in reference files, so it fits the 'good structure, minor organization gaps' anchor rather than the 'content appropriately split' anchor.

4 / 5

Total

19

/

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 capability list, explicit and detailed 'Use when' triggers, and explicit disambiguation against four adjacent skills. It answers what, when, and when-not with natural user-facing terminology and no padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Design, review, and refactor Neo4j graph data models", "migrating relational/document schemas to graph", "detecting anti-patterns (generic labels, supernodes, missing constraints)", "designing intermediate nodes for n-ary relationships", "enforcing schema with constraints and indexes" — comprehensive coverage of the skill's capabilities, matching the score-5 anchor rather than the 4 anchor whose coverage has minor gaps.

5 / 5

Completeness

Both questions are answered explicitly: what ("Design, review, and refactor Neo4j graph data models") and when ("Use when choosing node labels vs relationship types vs properties, migrating...") with concrete trigger phrases. It also adds explicit negative scope ("Does NOT handle Cypher query authoring..."), exceeding the score-5 anchor's requirement.

5 / 5

Trigger Term Quality

Natural terms a user would actually say are comprehensively covered: "graph data model", "node labels", "relationship types", "properties", "relational/document schemas", "supernodes", "constraints", "indexes", "n-ary relationships". This matches the comprehensive synonym-level coverage anchor; the 4 anchor requires only good coverage with a few natural terms missing.

5 / 5

Distinctiveness Conflict Risk

The Neo4j graph-modeling niche is distinct, and four explicit "Does NOT handle" clauses (Cypher authoring, Spring Data Neo4j, GraphQL, import) redirect the most likely confusion targets to named sibling skills — minimal conflict risk, matching the clear-niche anchor.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

neo4j-contrib/neo4j-skills

Path

neo4j-modeling-skill/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.