CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-gds-skill

Neo4j Graph Data Science (GDS) plugin — graph projection, algorithm execution, execution modes (stream/stats/mutate/write), memory estimation, and the GDS Python client (graphdatascience v1.21). Use when running gds.pageRank, gds.louvain, gds.wcc, gds.fastRP, gds.knn, gds.betweenness, gds.nodeSimilarity, or any gds.* procedure; projecting named in-memory graphs with gds.graph.project or graph.project; chaining algorithms with mutate mode; computing node embeddings for ML; building recommendation systems with FastRP + KNN. Also triggers on GraphDataScience, GdsSessions, graph catalog operations, ML pipelines, node classification, link prediction. Does NOT cover Aura Graph Analytics serverless sessions — use neo4j-aura-graph-analytics-skill. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT cover driver setup — use neo4j-driver-python-skill or other driver skill.

72

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

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 thoroughly covers specific capabilities, includes rich trigger terms spanning both API-level procedure names and conceptual use cases, and explicitly delineates boundaries with related skills. The 'Does NOT cover' clauses with skill redirections are a best practice that minimizes conflict risk. The description uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: graph projection, algorithm execution, execution modes (stream/stats/mutate/write), memory estimation, GDS Python client usage, chaining algorithms with mutate mode, computing node embeddings, building recommendation systems with FastRP + KNN.

3 / 3

Completeness

Clearly answers both 'what' (graph projection, algorithm execution, execution modes, memory estimation, GDS Python client) and 'when' with explicit 'Use when' clause listing specific procedures, operations, and use cases. Also includes explicit 'Does NOT cover' boundaries which further clarify when to use vs. not use this skill.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: specific procedure names (gds.pageRank, gds.louvain, gds.wcc, gds.fastRP, gds.knn, gds.betweenness, gds.nodeSimilarity, gds.*), class names (GraphDataScience, GdsSessions), and conceptual terms (graph catalog, ML pipelines, node classification, link prediction, node embeddings).

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit boundary definitions — explicitly states it does NOT cover Aura Graph Analytics, Cypher authoring, or driver setup, and names the alternative skills for each. The specific GDS procedure names and domain terminology create a clear niche unlikely to conflict with other 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 strong, highly actionable skill with excellent executable examples in both Cypher and Python, clear workflow sequencing with validation steps, and good error handling guidance. Its main weakness is length — at ~350 lines it pushes the boundary of conciseness, with some sections (weighted projection, relationship aggregation, multiple algorithm examples) that could be trimmed or offloaded to reference files. The progressive disclosure structure is reasonable but the body carries more detail than ideal for a SKILL.md overview.

Suggestions

Move detailed algorithm examples (especially weighted projection, relationship aggregation, and per-algorithm Cypher+Python dual examples) to references/algorithms.md, keeping only the most common 2-3 algorithms inline with brief examples.

Consolidate the algorithm selection table and core algorithms section to reduce redundancy — the table alone with links to reference docs would suffice for less common algorithms.

DimensionReasoningScore

Conciseness

The skill is generally efficient and avoids explaining basic concepts, but it's quite long (~350 lines) with some redundancy — e.g., the weighted projection and relationship aggregation examples could be condensed, and the algorithm selection table partially duplicates what's already shown in the core algorithms section. Some inline comments are helpful but others are unnecessary for Claude.

2 / 3

Actionability

Excellent actionability throughout — every algorithm and operation includes fully executable Cypher and Python code examples. The FastRP → KNN pipeline is a complete end-to-end workflow. MCP tool mapping provides concrete guidance on which tools to use for each operation type.

3 / 3

Workflow Clarity

The full workflow section provides a clear numbered sequence with estimation before projection, stream-to-verify before write, and explicit cleanup. The execution modes table clearly defines the pattern (stream → mutate → write). Memory estimation is emphasized as a prerequisite, and the checklist at the end serves as a validation checkpoint.

3 / 3

Progressive Disclosure

References to algorithms.md and graph-projection.md are well-signaled, but the main SKILL.md itself is quite long with substantial inline content that could be offloaded. The core algorithms section in particular could be shortened with details pushed to the referenced algorithms.md. No bundle files were provided to verify the referenced paths exist.

2 / 3

Total

10

/

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.