CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-driver-go-skill

Covers the Neo4j Go Driver v6 — driver lifecycle, ExecuteQuery, managed and explicit transactions, session config, error handling, data type mapping, and connection tuning. Use when writing Go code that connects to Neo4j, setting up NewDriver or ExecuteQuery, debugging sessions/transactions/result handling, or working with neo4j-go-driver v5→v6 migration. Triggers on NewDriver, ExecuteQuery, SessionConfig, ManagedTransaction, neo4j-go-driver. Does NOT handle Cypher query authoring — use neo4j-cypher-skill. Does NOT cover driver version migration steps — use neo4j-migration-skill.

92

1.42x
Quality

92%

Does it follow best practices?

Impact

94%

1.42x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

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

An exceptionally dense, executable reference: complete Go code for every driver pattern, decision tables, error-recovery feedback loops, and a closing checklist, with two genuine load-on-demand reference files that match their advertised contents. The only structural improvement is moving the Object Mapping preview and spatial-type detail into references to slim the main body. Strong result overall — no suggestions required.

DimensionReasoningScore

Conciseness

The body is almost entirely version-specific prescriptions (exact v6 signatures like 'neo4j.ExecuteQueryWithDatabase', retry semantics, SRID tables) with zero conceptual padding — it never explains what Neo4j or Go features are. Sections like 'One Driver per application. Goroutine-safe, connection-pooled, expensive to create' are terse driver facts, not library-101 prose, so every token earns its place.

5 / 5

Actionability

Every section is copy-paste-ready executable Go: 'neo4j.ExecuteQuery(ctx, driver, `MATCH...`, map[string]any{"name": "Alice"}, neo4j.EagerResultTransformer, neo4j.ExecuteQueryWithDatabase("neo4j"))' with exact option names, plus a decision table ('Choosing the Right API'), concrete error-handling with 'errors.As(err, &neo4jErr)', and a symptom/cause/fix table. No pseudocode anywhere.

5 / 5

Workflow Clarity

The database workflows carry explicit validation and feedback loops: 'driver.VerifyConnectivity(ctx)' at startup, 'res.Err()' checked after lazy iteration, 'return names, res.Err()' inside managed callbacks, a Common Errors table mapping symptom → cause → fix, and a final verification Checklist — satisfying the database-operations feedback-loop requirement. API-choice sequencing is made deterministic by the 'Choosing the Right API' table.

5 / 5

Progressive Disclosure

Structure is good: both referenced files ('references/advanced-config.md — connection pool tuning...', 'references/repository-pattern.md — repository wrapper pattern...') exist as real, one-level-deep content with content-summarizing pointers under an explicit 'Load on demand' signal. It falls short of a 5 because the 457-line body still inlines niche advanced material — the v6.2/v6.3 Object Mapping preview (struct parameters, CollectRecordsAs/SingleAs), the Spatial Types section, and the generic env-var/godotenv boilerplate — that fits the 'SKILL.md as overview' model better in reference files.

4 / 5

Total

19

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: comprehensive third-person capability list, an explicit 'Use when' clause with concrete API trigger terms, and clear negative boundaries to sibling skills. Its one real defect is self-contradictory migration scoping — the 'Use when' clause claims v5→v6 migration while a later sentence disclaims it in favor of neo4j-migration-skill — which both muddies the trigger and creates overlap risk.

Suggestions

Remove 'or working with neo4j-go-driver v5→v6 migration' from the 'Use when' clause (or narrow it to 'recognizing v5→v6 API renames') — it directly contradicts 'Does NOT cover driver version migration steps — use neo4j-migration-skill' and causes migration requests to fire this skill instead of the migration skill.

Add a few natural user phrasings to the trigger coverage, e.g. 'Bolt', 'graph database', 'Golang', and 'Aura', since current triggers lean on exact API identifiers users may not know yet.

DimensionReasoningScore

Specificity

It enumerates concrete capabilities in third-person voice ('Covers the Neo4j Go Driver v6 — driver lifecycle, ExecuteQuery, managed and explicit transactions, session config, error handling, data type mapping, and connection tuning'), comprehensively covering the driver's surface with named APIs rather than generic verbs. This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor (minor gaps) — no major driver capability is missing.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' ('driver lifecycle, ExecuteQuery, managed and explicit transactions, session config, error handling, data type mapping, and connection tuning') and the 'when' with concrete trigger phrases ('Use when writing Go code that connects to Neo4j, setting up NewDriver or ExecuteQuery, debugging sessions/transactions/result handling'). This matches the score-5 anchor exactly; the score-4 anchor requires a 'when' that 'could be more explicit', which is not the case here.

5 / 5

Trigger Term Quality

Good natural keyword coverage — users would literally say 'Go code that connects to Neo4j', 'NewDriver', 'ExecuteQuery', 'neo4j-go-driver', 'sessions/transactions' — plus an explicit 'Triggers on' list. It falls short of the comprehensive anchor because common phrasings users naturally say are absent: 'Bolt', 'graph database', 'Golang', 'Aura', or repo/import-path variants like 'github.com/neo4j/neo4j-go-driver'.

4 / 5

Distinctiveness Conflict Risk

It has a clear Go-driver niche with explicit negative boundaries ('Does NOT handle Cypher query authoring — use neo4j-cypher-skill'), which supports distinctiveness. However, the 'when' clause includes 'or working with neo4j-go-driver v5→v6 migration' while the next sentence states 'Does NOT cover driver version migration steps — use neo4j-migration-skill' — a direct self-contradiction that makes migration requests overlap with the sibling neo4j-migration-skill, fitting the 'mostly distinct; minor overlap risk with closely related skills' anchor rather than the minimal-conflict anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 11 missing

Warning

Total

14

/

16

Passed

Repository

neo4j-contrib/neo4j-skills

Path

neo4j-driver-go-skill/SKILL.md

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.