CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-spark-skill

Use when reading from or writing to Neo4j with Apache Spark or Databricks using the Neo4j Connector for Apache Spark 6.0 (org.neo4j.connectors:spark) or 5.x (org.neo4j:neo4j-connector-apache-spark). Covers SparkSession setup, DataFrame reads via labels/Cypher/relationship scan, DataFrame writes with SaveMode, node.keys for MERGE, relationship write mapping, partition and batch tuning, PySpark and Scala examples, Databricks cluster config, Databricks secrets for credentials, Delta Lake to Neo4j pipelines. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT handle the Python bolt driver — use neo4j-driver-python-skill. Does NOT handle GDS algorithms — use neo4j-gds-skill.

89

1.35x
Quality

96%

Does it follow best practices?

Impact

95%

1.35x

Average score across 2 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 action-dense, well-structured skill body: executable examples across all three runtimes, explicit validation checkpoints and a recovery table for batch/destructive writes, and clean one-level-deep references to real bundle files. Only minor conciseness trimming of duplicated setup examples would move it higher.

DimensionReasoningScore

Conciseness

The body is dense and mostly token-efficient — tables and code carry the load and there is no padding about what Neo4j or Spark is — but version matrices and duplicated setup examples across PySpark/Scala/Databricks add some length that could be trimmed or delegated to references.

4 / 5

Actionability

Copy-paste-ready executable code spans PySpark, Scala, and Databricks for setup, reads, writes, relationships, pre-write scripts, Delta pipelines, and tuning, with concrete option strings and exact Maven coordinates covering the common cases.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints — the Delta pipeline 'nodes before relationships' ordering, the Overwrite-mode requirement to create uniqueness constraints before MERGE, the coalesce(1) guard for relationship writes, and a closing checklist with a feedback-oriented Common Errors table for recovery.

5 / 5

Progressive Disclosure

SKILL.md is a well-signaled overview with two clearly named, one-level-deep references — [references/read-patterns.md] and [references/write-patterns.md], both real files — placing the bulk of the option reference off-page while keeping navigation explicit.

5 / 5

Total

19

/

20

Passed

Description

100%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, third-person description that pairs explicit trigger guidance ('Use when ...') with comprehensive, concrete capabilities and precise boundary clauses against sibling Neo4j skills. Voice, trigger phrasing, and distinctiveness all hit the top anchors.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — SparkSession setup, DataFrame reads via labels/Cypher/relationship scan, writes with SaveMode, node.keys for MERGE, partition/batch tuning, Databricks cluster config/secrets, Delta pipelines — giving comprehensive coverage of the connector's capability surface.

5 / 5

Completeness

Opens with an explicit 'Use when ...' trigger clause and pairs it with a detailed 'what' enumeration, explicitly answering both what the skill does and when to use it with concrete trigger phrases.

5 / 5

Trigger Term Quality

Covers natural trigger terms a user would say ('reading from or writing to Neo4j with Apache Spark or Databricks', 'Delta Lake to Neo4j pipelines') alongside precise technical identifiers like Maven coordinates, giving comprehensive keyword coverage including synonyms (Spark/Databricks, 6.0/5.x).

5 / 5

Distinctiveness Conflict Risk

Explicit 'Does NOT handle' boundary clauses redirect Cypher authoring, the Python bolt driver, and GDS to three other named skills, carving a clear niche with minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

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.