CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-aura-graph-analytics-skill

Serverless Aura Graph Analytics (AGA) GDS Sessions — covers GdsSessions, AuraGraphDataScience, AuraAPICredentials, DbmsConnectionInfo, SessionMemory, get_or_create, remote graph projection with gds.graph.project.cypher and gds.graph.project.remote, gds.graph.project.native, gds.graph.construct, graphdatascience client 2.0 session endpoints, async compute and gds.jobs, AuraDB Cypher API memory/sessionId projection, algorithms, write-back, and session lifecycle. Use for AuraDB-connected, self-managed Neo4j, or standalone DataFrame/Spark session workloads. Does NOT cover the embedded GDS plugin on Aura Pro or self-managed Neo4j — use neo4j-gds-skill. Does NOT handle Cypher authoring — use neo4j-cypher-skill. Does NOT cover Snowflake Graph Analytics — use neo4j-snowflake-graph-analytics-skill.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
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 well-engineered, highly actionable skill: complete executable code for all three deployment modes, a clearly sequenced 8-step workflow with validation checkpoints and an error-recovery table, and properly signaled reference files that exist and deliver the promised content. The main improvement lever is moving the 1.x migration table and per-version changelog detail into a reference file to tighten the main body.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, version-pinned knowledge (rename tables, tier caps, ValueError gotchas) and avoids explaining concepts Claude already knows, with legacy 1.x material correctly isolated under a 'Client 1.x (legacy)' section. Minor trimming opportunities remain — the 1.x migration table is sizeable inline content, and the string-properties limitation is stated in three places (projection notes, construct notes, Common Errors). Not 5 because not every token earns its place; not 3 because there is no padded or redundant concept explanation.

4 / 5

Actionability

Every step ships complete, copy-paste-ready code: auth via AuraAPICredentials.from_env() with env var names, sessions.estimate(...) with both list and config forms, three session-creation modes, four projection variants, algorithm mutate/stream/write examples, a full job-polling loop with error handling, retrieval, and cleanup. All examples are executable Python or Cypher covering the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Steps 1–8 are clearly sequenced (Authenticate → Estimate → Create → Project → Run → Poll → Retrieve → Write back/Clean up) with an explicit validation checkpoint (gds.verify_connectivity() after creation), feedback loops for error recovery (a ten-row Common Errors cause/fix table and job polling that raises on failure), and a final checklist. Validation for the destructive cleanup operation is present ("Write before delete; unwritten results lost"), so the destructive/batch cap at 3 does not apply.

5 / 5

Progressive Disclosure

Good structure with clearly signaled one-level-deep references ("Load on demand: [references/workflows.md] ... [references/limitations.md]"), and both referenced files exist and contain exactly what is claimed (verified: workflow examples and the SessionMemory tier / feature-comparison tables). Not 5 because the ~440-line body inlines detail that could live in references — notably the 1.x migration table and the per-version (2.0/2.1/2.2/2.3) addition changelogs — leaving SKILL.md heavier than a lean overview.

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: comprehensive concrete capability coverage with exact API names, an explicit 'Use for' clause covering all three deployment modes, and explicit exclusion clauses that cleanly separate it from sibling Neo4j skills. The only minor gap is a few missing natural trigger synonyms (Pandas, algorithm names).

DimensionReasoningScore

Specificity

The description enumerates concrete, specific capabilities — "remote graph projection with gds.graph.project.cypher and gds.graph.project.remote, gds.graph.project.native, gds.graph.construct", "async compute and gds.jobs", "write-back, and session lifecycle" — with exact class and endpoint names. Coverage spans auth, projection variants, algorithms, async jobs, retrieval, and lifecycle, matching the comprehensive multi-action anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers both: what ("covers GdsSessions, ... remote graph projection ... async compute and gds.jobs ... algorithms, write-back, and session lifecycle") and when ("Use for AuraDB-connected, self-managed Neo4j, or standalone DataFrame/Spark session workloads") with concrete deployment scenarios. The 'when' is explicit and specific with three workload types plus explicit exclusion clauses, fitting the 5 anchor rather than the 4 anchor where 'when' could be more specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Aura Graph Analytics (AGA) GDS Sessions", "AuraDB", "Neo4j", "Cypher", "DataFrame/Spark", "embedded GDS plugin", "graphdatascience client" — terms users would naturally say in this domain. A few natural terms are missing (e.g., "Pandas", specific algorithm names like PageRank, "Graph Data Science library" as a synonym), so it falls just below the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (serverless Aura Graph Analytics GDS Sessions) with explicit negative boundaries redirecting to neighboring skills: "Does NOT cover the embedded GDS plugin ... use neo4j-gds-skill", "Does NOT handle Cypher authoring — use neo4j-cypher-skill", "Does NOT cover Snowflake Graph Analytics". This minimizes conflict risk with closely related skills, matching the 5 anchor.

5 / 5

Total

19

/

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.

Validation — 15 / 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

Path

neo4j-aura-graph-analytics-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.