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.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

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.

An exceptionally actionable, well-sequenced skill body whose code examples cover all deployment modes with explicit validation checkpoints and error recovery. Minor redundancy and heavy inline detail keep it just short of top marks on conciseness and progressive disclosure.

Suggestions

Move the 1.x legacy migration table and the Cypher API session-management snippets into a reference file to shrink the SKILL.md body and lift progressive_disclosure.

Trim the Deployment Decision Table's overlap with When to Use / When NOT to Use, or merge those sections to remove the redundancy.

DimensionReasoningScore

Conciseness

Telegraphic, information-dense body with no concept explanations Claude already knows, and version-sensitive material properly quarantined under 'Client 1.x (legacy)'. Not a 5 because the 15-line Checklist and the Deployment Decision Table partially restate the When to Use / When NOT to Use sections — minor trimming is possible.

4 / 5

Actionability

Fully executable, copy-paste-ready code for all three deployment modes, all projection variants, async job polling, write-back, and cleanup, plus a Common Errors table with concrete causes and fixes. Not a 4 because examples cover the common cases completely with no pseudocode.

5 / 5

Workflow Clarity

Steps 1–8 are explicitly sequenced (Authenticate → Estimate → Create → Project → Run → Poll → Retrieve → Write back/Clean up) with validation checkpoints (verify_connectivity(), memory estimation before creation, job-status failure raise), an error-recovery table, and a checklist. Not a 4 because validation, recovery feedback, and sequencing are all explicitly present.

5 / 5

Progressive Disclosure

Two real, clearly labeled one-level-deep references in a 'Load on demand' section (both files verified to exist), with the core workflow appropriately inline. Not a 5 because the ~433-line body inlines substantial detail (1.x migration table, Cypher API session-management snippets, GraphSAGE job specifics) that could live in the existing 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 dense, highly specific description that explicitly states what the skill covers and when to use it, with strong negative triggers that cleanly separate it from sibling Neo4j skills. Its only weakness is keyword load skewed toward API names over natural user phrasing.

Suggestions

Add a few natural user-facing trigger phrases (e.g., 'run graph algorithms like PageRank or Louvain in the cloud') alongside the API names to improve trigger_term_quality.

Spell out 'graph data science' as a natural synonym since users may search that phrase rather than 'GDS'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions and API surfaces — 'remote graph projection with gds.graph.project.cypher and gds.graph.project.remote', 'gds.graph.construct', 'async compute and gds.jobs', 'write-back, and session lifecycle' — comprehensively covering creation through cleanup. Not a 4 because coverage of the full session workflow has no material gaps.

5 / 5

Completeness

Explicitly answers both: 'what' via 'covers GdsSessions, ... write-back, and session lifecycle' and 'when' via 'Use for AuraDB-connected, self-managed Neo4j, or standalone DataFrame/Spark session workloads', with additional negative triggers. Not a 4 because the when-to-use guidance is explicit, not weakly implied.

5 / 5

Trigger Term Quality

Good natural-term coverage ('graph analytics', 'GDS', 'Aura', 'Neo4j', 'algorithms', 'serverless', 'DataFrame/Spark'), but much of the keyword load is API class names rather than phrases a user would naturally say. Not a 5 because common user phrasings (specific algorithm names like PageRank/community detection, 'graph data science') are absent.

4 / 5

Distinctiveness Conflict Risk

Clear niche (serverless Aura GDS Sessions) with explicit sibling disambiguation: 'Does NOT cover the embedded GDS plugin on Aura Pro or self-managed Neo4j — use neo4j-gds-skill', plus redirects to neo4j-cypher-skill and neo4j-snowflake-graph-analytics-skill. Not a 4 because conflict risk with adjacent Neo4j skills is explicitly and fully addressed.

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.