CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-driver-python-skill

Neo4j Python Driver v6 — driver lifecycle, execute_query, managed and explicit transactions, async (AsyncGraphDatabase), result handling, data type mapping, error handling, UNWIND batching, connection pool tuning, and causal consistency. Use when writing Python code that connects to Neo4j via GraphDatabase.driver, execute_query, execute_read, execute_write, AsyncGraphDatabase, neo4j.Result, or RoutingControl. Package name is `neo4j` (not neo4j-driver) since v6. Python >=3.10 required. Does NOT handle Cypher query authoring — use neo4j-cypher-skill. Does NOT cover driver upgrades or breaking changes — use neo4j-migration-skill. Does NOT cover GraphRAG pipelines (neo4j-graphrag package) — use neo4j-graphrag-skill.

74

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

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 excellent skill description that excels across all dimensions. It provides comprehensive, specific capabilities, includes highly relevant trigger terms that developers would naturally use, explicitly defines both 'what' and 'when', and proactively prevents conflicts with related skills through clear boundary statements. The inclusion of version constraints (v6, Python >=3.10) and package naming clarification adds further precision.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: driver lifecycle, execute_query, managed and explicit transactions, async support, result handling, data type mapping, error handling, UNWIND batching, connection pool tuning, and causal consistency.

3 / 3

Completeness

Clearly answers 'what' (driver lifecycle, transactions, async, batching, etc.) and 'when' with an explicit 'Use when writing Python code that connects to Neo4j via...' clause. Also explicitly states what it does NOT cover with references to other skills, further clarifying scope.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms a developer would use: 'GraphDatabase.driver', 'execute_query', 'execute_read', 'execute_write', 'AsyncGraphDatabase', 'neo4j.Result', 'RoutingControl', 'neo4j' package name, and 'Python' — these are exactly the terms users would mention when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit boundary-setting via 'Does NOT handle' clauses that reference specific companion skills (neo4j-cypher-skill, neo4j-migration-skill, neo4j-graphrag-skill). The triggers are narrowly scoped to Python driver API terms, making conflicts very unlikely.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a high-quality skill that provides comprehensive, actionable guidance for Neo4j Python driver v6 usage. Its greatest strengths are the executable code examples covering all major APIs, the clear API selection table, the extensive common errors table, and well-structured progressive disclosure to reference files. The only notable weakness is moderate verbosity in a few sections (env vars, some explanatory text) that could be trimmed without losing clarity.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining basic concepts, but some sections are slightly verbose — e.g., the environment variables section with full .env file format and dotenv usage is standard knowledge, and the common errors table, while useful, is quite long. The auth options line and URI scheme table add value but the overall document could be tightened by ~20%.

2 / 3

Actionability

Excellent actionability throughout — every section includes executable, copy-paste-ready Python code with correct imports, real parameter names, and concrete examples. The execute_query, managed transactions, async, UNWIND batching, and error handling sections all provide fully working code snippets with clear annotations.

3 / 3

Workflow Clarity

The API selection table clearly guides which API to use when. The driver lifecycle section establishes a clear sequence (create → verify → use → close). The checklist at the end serves as a validation checkpoint. The common errors table acts as a troubleshooting feedback loop. For a driver usage skill (not a destructive multi-step process), the workflow guidance is thorough and well-sequenced.

3 / 3

Progressive Disclosure

The skill provides a comprehensive but scannable overview with clear one-level-deep references to four specific reference files (async.md, data-types.md, performance.md, transactions.md) with descriptions of what each contains. The 'When to Use / When NOT to Use' section cleanly defers to other skills. Content is well-organized with headers, tables, and code blocks for easy navigation.

3 / 3

Total

11

/

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.