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
92%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
66ed0e1
Table of Contents
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.