Neo4j Modeling Skill

This is your Neo4j schema design specialist. It helps you decide whether something should be a node, relationship, property, or label, migrate relational schemas to graph, and spot anti-patterns like supernodes or generic labels. Before touching an existing database, it runs schema inspection queries to see what's there. It enforces conventions like uniqueness constraints on every merge key, PascalCase labels, and SCREAMING_SNAKE_CASE relationships. The intermediate node pattern guidance is solid for when relationships need properties or connect more than two entities. It won't write Cypher queries or handle imports, those have separate skills. If you're modeling graphs instead of just querying them, this is the one to reach for.

skills.sh installs: 1.2K
GitHub stars: 121
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add neo4j-contrib/neo4j-skills --skill neo4j-modeling-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

When to Use

Designing graph model from scratch (domain → nodes, rels, props)
Reviewing existing model for anti-patterns
Deciding node vs property vs relationship vs label
Migrating relational or document schema to graph
Designing intermediate nodes for n-ary or complex relationships
Detecting and mitigating supernode / high-fanout problems
Choosing and creating constraints + indexes for a model

When NOT to Use

Writing or optimizing Cypher → neo4j-cypher-skill
Spring Data Neo4j (@Node, @Relationship) → neo4j-spring-data-skill
GraphQL type definitions → neo4j-graphql-skill
Importing data (LOAD CSV, APOC import) → neo4j-import-skill

Inspect Before Designing

On existing database, run first — never propose changes without current state:

CALL db.schema.visualization() YIELD nodes, relationships RETURN nodes, relationships;
SHOW CONSTRAINTS YIELD name, type, labelsOrTypes, properties RETURN name, type, labelsOrTypes, properties;
SHOW INDEXES YIELD name, type, labelsOrTypes, state WHERE state = 'ONLINE' RETURN name, type, labelsOrTypes;

SKILL.md on GitHub