CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-driver-java-skill

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

1.34x
Quality

92%

Does it follow best practices?

Impact

98%

1.34x

Average score across 3 eval scenarios

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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.