neo4j-cypher

Write, execute, and optimize Cypher 25 queries against Neo4j graph databases.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-cypher-eklyukin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-cypher
Source: https://github.com/eklyukin/my-ai-config/tree/main/skills/neo4j-cypher
Command: npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-cypher-eklyukin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing correct, performant Cypher against a large Neo4j graph is error-prone: syntax traps, deprecated clauses, missing indexes, and RBAC misconfigurations cause failed queries and slow performance. This Skill provides a CLI-first reference and execution workflow for authoring, validating, and running Cypher 25 queries safely. ## Core Features & Use Cases - Cypher Authoring & Validation: Enforces Cypher 25 defaults, schema-first querying, a 40+ syntax trap table, and EXPLAIN/PROFILE-based performance tuning with index guidance. - Multi-Path Execution: Runs queries via neo4j-cli over Bolt (default), Python Bolt driver, Neuronet MCP tools, or an HTTP Query API wrapper, with stored credentials and GCP Secret Manager support. - Admin & RBAC Operations: Covers user/role/privilege management, property-based access control (PBAC), built-in roles, and permission audits against the system database. - Use Case: A developer needs to grant a new microservice write access to specific node labels, then verify the grants. The Skill supplies the exact GRANT statements, the minimum-privilege mapping table, and the verification query using SHOW PRIVILEGES with segment filtering. ## Quick Start Ask the assistant to inspect the graph schema and write an optimized Cypher query, for example: show me the schema and count nodes per label using neo4j-cli.

Frequently Asked Questions about neo4j-cypher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Cypher query against Neo4j from the command line?▼

Use neo4j-cli query with a stored credential, for example: neo4j-cli query --credential default 'MATCH (n) RETURN count(n)'. Add --rw for writes and system-database admin commands, and --max-rows 0 to lift the default 100-row output cap.

How do I optimize slow Cypher queries in Neo4j?▼

Run EXPLAIN or PROFILE on the query and look for red flags like AllNodesScan, CartesianProduct, NodeByLabelScan, and Eager operators. Indexes only activate when nodes carry a label, and MERGE needs a constraint for atomicity.

Does Neo4j Community Edition support roles and privileges?▼

No. Roles, privileges, and property-based access control require Neo4j Enterprise Edition. Community Edition supports only basic user and password management.

Why does SHOW USERS fail without the --rw flag in neo4j-cli?▼

The EXPLAIN preflight write-classifies system-database commands, so SHOW USERS and SHOW PRIVILEGES fail without --rw. When running any query against the system database, pass -d system --rw.

What is the fastest way to delete millions of relationships in Neo4j Aura?▼

Use apoc.periodic.iterate with batchSize around 50000 and parallel set to false, which achieves roughly 11,600 deletions per second. Concurrent Python workers do not help because server-side lock contention serializes the writes.

Can I grant privileges directly to a Neo4j user instead of a role?▼

No. GRANT targets roles, not users. Create a role, grant privileges to it, then assign the role to the user with GRANT ROLE name TO user. Assigning privileges requires the admin role.