CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-import-skill

Import structured data into Neo4j — LOAD CSV, CALL IN TRANSACTIONS, neo4j-admin database import full (offline bulk), apoc.load.csv/json, apoc.periodic.iterate, driver batch writes. Covers method selection, header file format, type coercion, null handling, ON ERROR modes, CONCURRENT TRANSACTIONS, pre-import constraint setup, and post-import validation. Use when importing CSV/JSON/Parquet files, migrating relational data to graph, or bulk-loading large datasets. Does NOT handle unstructured document/PDF/vector chunking pipelines — use neo4j-document-import-skill. Does NOT handle live app write patterns (MERGE/CREATE) — use neo4j-cypher-skill. Does NOT handle neo4j-admin backup/restore/config — use neo4j-cli-tools-skill.

82

1.35x
Quality

90%

Does it follow best practices?

Impact

77%

1.35x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable, well-sequenced import guide with executable code, explicit validation loops, and real, clearly-signaled reference files. Its main weakness is size: full reference tables and many version-specific annotations live inline in SKILL.md where leaner summaries with pointers to reference files would respect the token budget better.

Suggestions

Move the 'CALL IN TRANSACTIONS — Full Reference' syntax grammar, REPORT STATUS column table, and neo4j-admin key-flags table into a reference file (e.g. references/call-in-transactions-reference.md), keeping only the common patterns and a pointer in SKILL.md.

Consolidate scattered version annotations (2026.02+ dry-run, 2025.12 bad-tolerance default change, 2026.06+/2026.07+ vector and delimiter changes) into a single 'Version-specific changes' or 'Old patterns' section so time-sensitive details don't penalize the main flow.

Trim the batch-size guidance and APOC config tables to the rows that change decisions, or fold them into the same reference file as the CALL IN TRANSACTIONS detail.

DimensionReasoningScore

Conciseness

Dense, high-value content with almost no re-teaching of concepts Claude already knows, but at ~500 lines it inlines full syntax references and flag tables, and scatters many time-sensitive version annotations (2026.02+, 2025.12, 2026.06+, 2026.07+) outside any deprecated/versions section, which could be trimmed or consolidated.

4 / 5

Actionability

Fully executable, copy-paste-ready Cypher and bash throughout — e.g. the complete 'LOAD CSV WITH HEADERS ... IN TRANSACTIONS OF 10000 ROWS ON ERROR CONTINUE REPORT STATUS' pattern and the full 'neo4j-admin database import full' command with flags — covering common cases, plus an error-to-fix table for known failures.

5 / 5

Workflow Clarity

Clear sequencing with explicit validation checkpoints and feedback loops appropriate to batch operations: an exact-order pre-import checklist ('Run in this exact order — skipping causes hard-to-debug duplicates'), a method decision table, ON ERROR modes with REPORT STATUS error tracking, and post-import validation that polls populationPercent until indexes are ONLINE.

5 / 5

Progressive Disclosure

Three one-level-deep reference files (driver-batch-write.md, data-importer-gui.md, post-import-refactoring.md) all exist and are clearly signaled both inline and in a References section, but bulk reference material such as the 'CALL IN TRANSACTIONS — Full Reference' syntax tables and the neo4j-admin key-flags table is inlined in SKILL.md rather than split into reference files.

4 / 5

Total

18

/

20

Passed

Description

92%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: it names five concrete import methods, states explicit trigger conditions, and pre-empts conflicts with three sibling skills via explicit Does-NOT-handle boundaries. The only gap is a handful of missing natural trigger synonyms and file extensions.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'LOAD CSV, CALL IN TRANSACTIONS, neo4j-admin database import full (offline bulk), apoc.load.csv/json, apoc.periodic.iterate, driver batch writes' — plus concrete coverage areas (type coercion, null handling, ON ERROR modes, constraint setup, post-import validation). Comprehensive with no vague filler.

5 / 5

Completeness

Explicitly answers both 'what' (named import methods and coverage areas) and 'when' ('Use when importing CSV/JSON/Parquet files, migrating relational data to graph, or bulk-loading large datasets') with concrete trigger phrases, going beyond the anchor's level of explicitness.

5 / 5

Trigger Term Quality

Natural phrases like 'importing CSV/JSON/Parquet files', 'migrating relational data to graph', and 'bulk-loading large datasets' are present, but a few common variations users would say are missing (e.g. 'load data into Neo4j', 'ETL', '.csv' extensions). Good coverage, just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (structured data import into Neo4j) with three explicit negative boundaries — 'Does NOT handle unstructured document/PDF/vector chunking pipelines', 'Does NOT handle live app write patterns', 'Does NOT handle neo4j-admin backup/restore/config' — each redirecting to a named sibling skill, minimizing wrong-skill triggering.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (501 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

neo4j-contrib/neo4j-skills

Path

neo4j-import-skill/SKILL.md

Revision

4555b7b

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill