CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

This is a strong, highly actionable skill for Neo4j graph data modeling. Its greatest strengths are the concrete decision tables, executable Cypher examples, and well-structured workflow from inspection through schema enforcement with validation checkpoints. The main weaknesses are moderate verbosity (some redundancy between sections) and a long monolithic document that could benefit from splitting detailed patterns into referenced files, especially since the referenced modeling-patterns.md bundle file is not provided.

Suggestions

Consider extracting the Relational → Graph Migration Table and Vector/Embedding sections into separate reference files to reduce the main document length and improve progressive disclosure.

Remove redundant guidance that appears in multiple sections (e.g., generic labels/rels are warned against in Defaults, Anti-Patterns Table, and the Checklist) — consolidate to one authoritative location and reference it.

DimensionReasoningScore

Conciseness

The skill is comprehensive and mostly efficient, but some sections are slightly verbose — the anti-patterns table repeats guidance already covered in earlier sections (e.g., generic labels, supernode mitigation), and the `id` anti-pattern entry is overly hedged. The decision tables and naming conventions are lean and well-structured, but overall the document could be tightened by ~15-20% without losing information.

2 / 3

Actionability

Excellent actionability throughout: executable Cypher for schema inspection, constraint/index creation, supernode detection, and bucket patterns. Decision tables provide concrete 'if X then Y' guidance. The schema enforcement section is copy-paste ready with 8 distinct DDL examples covering all constraint/index types.

3 / 3

Workflow Clarity

Clear workflow: inspect schema first → define use cases → design model → create constraints/indexes → validate indexes are ONLINE. The 'Inspect Before Designing' section enforces a mandatory first step, the schema enforcement section includes a validation poll step, and the assessment output format provides a structured review workflow with severity-based action gates (ERROR = stop and fix).

3 / 3

Progressive Disclosure

References section points to a bundle file (references/modeling-patterns.md) and external docs, which is good progressive disclosure. However, no bundle files were provided, so the referenced modeling-patterns.md may not exist. The main document is quite long (~300+ lines) and some content like the full vector/embedding section or the relational migration table could arguably be split into reference files. The structure within the document is well-organized with clear headers.

2 / 3

Total

10

/

12

Passed

Description

100%

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

This is an exemplary skill description. It provides highly specific capabilities, comprehensive trigger terms covering the Neo4j graph modeling domain, explicit 'Use when' guidance with multiple scenarios, and outstanding distinctiveness through explicit negative boundaries referencing related skills. The description is thorough without being padded, uses proper third-person voice throughout, and would enable Claude to confidently select or reject this skill from a large pool.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: design/review/refactor graph data models, choosing node labels vs relationship types vs properties, migrating relational/document schemas, detecting anti-patterns (with examples), designing intermediate nodes, enforcing schema with constraints and indexes, assessing models against best practices.

3 / 3

Completeness

Clearly answers both 'what' (design, review, refactor Neo4j graph data models with specific sub-tasks listed) and 'when' (explicit 'Use when...' clause with six distinct trigger scenarios). The negative boundaries ('Does NOT handle...') further clarify when NOT to use it, which strengthens completeness.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Neo4j', 'graph data model', 'node labels', 'relationship types', 'properties', 'relational schema', 'anti-patterns', 'supernodes', 'constraints', 'indexes', 'n-ary relationships'. These are terms a user working with Neo4j modeling would naturally use.

3 / 3

Distinctiveness Conflict Risk

Exceptionally distinctive — explicitly delineates boundaries against four related Neo4j skills (cypher, spring-data, graphql, import) with cross-references. The focus on data modeling specifically creates a clear niche that is unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
neo4j-contrib/neo4j-skills
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.