Neo4j Java Driver v6 — driver lifecycle, Maven/Gradle setup, executableQuery, executeRead/Write managed transactions, explicit transactions, async/reactive patterns, error handling, data type mapping, connection pool tuning, causal consistency/bookmarks. Use when writing Java or Kotlin code that connects to Neo4j via GraphDatabase.driver, executableQuery, SessionConfig, executeRead, executeWrite, or TransactionCallback. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT cover driver version upgrades — use neo4j-migration-skill. Does NOT cover Spring Data Neo4j (@Node, Neo4jRepository) — use neo4j-spring-data-skill.
94
92%
Does it follow best practices?
Impact
98%
1.34xAverage score across 3 eval scenarios
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 hits all the marks. It provides highly specific capabilities, includes natural trigger terms that developers would actually use, explicitly states both what it does and when to use it, and goes above and beyond by clearly delineating boundaries with related skills to minimize conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: driver lifecycle, Maven/Gradle setup, executableQuery, managed transactions, explicit transactions, async/reactive patterns, error handling, data type mapping, connection pool tuning, causal consistency/bookmarks. | 3 / 3 |
Completeness | Clearly answers 'what' (driver lifecycle, setup, transactions, error handling, etc.) and 'when' with an explicit 'Use when writing Java or Kotlin code that connects to Neo4j via...' clause. Additionally provides explicit negative boundaries with 'Does NOT handle' clauses directing to other skills. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms a developer would use: 'Java', 'Kotlin', 'Neo4j', 'GraphDatabase.driver', 'executableQuery', 'SessionConfig', 'executeRead', 'executeWrite', 'TransactionCallback', 'Maven', 'Gradle'. These are exactly the API names and keywords a user would mention. | 3 / 3 |
Distinctiveness Conflict Risk | Exceptionally distinctive — explicitly delineates boundaries against three related skills (neo4j-cypher-skill, neo4j-migration-skill, neo4j-spring-data-skill) with specific exclusion clauses, making conflict risk very low. | 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, comprehensive skill file for Neo4j Java Driver v6. Its greatest strengths are fully executable code examples, clear decision tables for API selection, and explicit anti-pattern documentation with fixes. The main weakness is length — some sections (Object Mapping, parts of the Common Errors table) could be moved to reference files to improve token efficiency, though the content itself is valuable and well-organized.
Suggestions
Consider moving the Object Mapping section to a reference file to reduce the main skill's token footprint — it's a secondary pattern that not all users need immediately.
The Common Errors table is valuable but lengthy; consider splitting it into 'critical errors' (inline) and 'extended errors' (reference file) to improve conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining basic concepts, but it's quite long (~400 lines). Some sections like Object Mapping and the extensive Common Errors table could be trimmed or moved to reference files. The null safety section and explicit transaction guidance are well-targeted, but the overall volume pushes past what's strictly necessary in the main skill file. | 2 / 3 |
Actionability | Excellent actionability throughout — every section includes complete, executable Java code with correct imports/patterns. Maven/Gradle snippets are copy-paste ready, environment variable patterns are concrete, and anti-patterns are shown alongside correct alternatives (e.g., ResultConsumedException example). The Common Errors table maps specific mistakes to specific fixes. | 3 / 3 |
Workflow Clarity | The 'Choosing the Right API' decision table clearly sequences which API to use when. The explicit transaction section includes proper error handling with rollback wrapped in try/catch and addSuppressed. The managed transaction section explicitly warns about consuming results inside callbacks with ❌/✅ examples. The checklist at the end serves as a validation checkpoint. Commit uncertainty is explicitly addressed with idempotent design guidance. | 3 / 3 |
Progressive Disclosure | The main file covers the essential patterns while clearly referencing two deeper files (references/async-reactive.md and references/advanced-config.md) with specific descriptions of their contents. External docs are linked. The structure flows logically from setup → API choice → common patterns → errors → references. Advanced topics like async/reactive and advanced config are appropriately deferred. | 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.