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.
90
88%
Does it follow best practices?
Impact
96%
1.26xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
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 highly specific capabilities, rich natural trigger terms, explicit 'Use when' guidance, and outstanding distinctiveness through explicit negative boundary clauses that reference alternative skills by name. It serves as a strong example of how to write a skill description in a multi-skill ecosystem.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and tools: LOAD CSV, CALL IN TRANSACTIONS, neo4j-admin database import full, apoc.load.csv/json, apoc.periodic.iterate, driver batch writes. Also enumerates specific sub-topics like header file format, type coercion, null handling, ON ERROR modes, etc. | 3 / 3 |
Completeness | Clearly answers both 'what' (structured data import into Neo4j with specific methods and topics) and 'when' (explicit 'Use when importing CSV/JSON/Parquet files, migrating relational data to graph, or bulk-loading large datasets'). Also includes explicit negative boundaries directing to other skills. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'importing CSV/JSON/Parquet files', 'migrating relational data to graph', 'bulk-loading large datasets', 'LOAD CSV', 'neo4j-admin import'. These are terms a user would naturally use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Exceptionally distinctive — explicitly delineates boundaries with three 'Does NOT handle' clauses pointing to specific alternative skills (neo4j-document-import-skill, neo4j-cypher-skill, neo4j-cli-tools-skill). This makes it very unlikely to conflict with related Neo4j skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%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, highly actionable skill that provides comprehensive coverage of Neo4j import methods with executable examples, clear decision tables, and explicit validation workflows. Its main weakness is length — at 400+ lines, it functions more as a complete reference manual than a concise skill overview, with several sections (CALL IN TRANSACTIONS full reference, neo4j-admin flags, APOC patterns) that could be offloaded to reference files. The workflow clarity and error handling guidance are exemplary.
Suggestions
Move the full CALL IN TRANSACTIONS reference (syntax, ON ERROR modes table, CONCURRENT details, REPORT STATUS columns, batch size guidance) into a separate reference file like references/call-in-transactions.md, keeping only the most common pattern inline.
Move the neo4j-admin import section (flags table, header format details, incremental import) into references/neo4j-admin-import.md, retaining only the command structure example and key gotchas in the main skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive and mostly efficient, but its sheer length (~400+ lines) includes some content that could be offloaded to reference files (e.g., the full CALL IN TRANSACTIONS reference, neo4j-admin flag tables, APOC patterns). Some explanatory notes like 'Fastest method: ~3 min for 31M nodes / 78M rels on SSD' and the constraint ordering rationale add value but push toward verbosity. Overall mostly efficient but could be tightened. | 2 / 3 |
Actionability | Excellent actionability throughout — every section provides executable Cypher queries, bash commands, and concrete examples with proper syntax. The LOAD CSV patterns include full type coercion, null handling, and real column names. The neo4j-admin commands are copy-paste ready with header file format examples. The common errors table maps specific error messages to concrete fixes. | 3 / 3 |
Workflow Clarity | The pre-import checklist is explicitly ordered ('Run in this exact order — skipping causes hard-to-debug duplicates'), with clear rationale for each step. The workflow follows a logical sequence: constraints → verify APOC → confirm PRIMARY → count rows → encode → import nodes → import relationships → post-import validation. Validation checkpoints are explicit (poll index populationPercent, spot-check null keys, count verification). The MCP write gate adds another validation layer before execution. | 3 / 3 |
Progressive Disclosure | The skill references several external files (references/driver-batch-write.md, references/data-importer-gui.md, references/post-import-refactoring.md, neo4j-cypher-skill/references/indexes.md) which is good progressive disclosure design. However, no bundle files were provided, so we can't verify these exist. More importantly, the SKILL.md itself is very long — the full CALL IN TRANSACTIONS reference, neo4j-admin flag tables, and APOC patterns could reasonably be split into reference files, keeping the main skill as a concise overview with pointers. | 2 / 3 |
Total | 10 / 12 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 — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (502 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 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.