CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-aura-provisioning-skill

Provisions and manages Neo4j Aura instances via CLI (aura-cli v1.7+) or REST API. Use when creating, pausing, resuming, resizing, or deleting AuraDB Free/Professional/Business Critical/VDC instances; downloading credentials; scripting CI/CD pipelines; polling async status; or using the Terraform neo4j-labs/neo4jaura provider. Covers auth setup (client credentials OAuth2), credential lifecycle (download once — never recoverable), instance type selection, region codes, and Python provisioning scripts. Does NOT handle Cypher queries — use neo4j-cypher-skill. Does NOT cover Graph Data Science algorithms — use neo4j-gds-skill or neo4j-aura-graph-analytics-skill. Does NOT cover neo4j-admin/cypher-shell — use neo4j-cli-tools-skill.

86

1.09x
Quality

93%

Does it follow best practices?

Impact

95%

1.09x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

Excellent operational content: fully executable CLI/REST/Python/Terraform workflows with explicit polling validation, destructive-operation safeguards, and error-recovery guidance. The main weakness is bundle integration — the four references/ files are never linked from SKILL.md, and inline tier/region tables duplicate content that belongs in them.

Suggestions

Link the existing bundle files from SKILL.md (e.g., a '## Deep dives' section: tiers → references/aura-tiers.md, monitoring → references/aura-monitoring.md, data import → references/data-importer.md, Aura Agent → references/aura-agent.md) so they are discoverable at the right moments.

Move the region-code tables (and fold the tier decision table into a pointer) into references/aura-tiers.md or a references/regions.md, keeping only a one-line pointer in SKILL.md — this trims ~90 lines from the main file and eliminates duplication with the tier reference.

Replace the Step 4 cypher-shell verification with a check consistent with the skill's own scope (e.g., a REST GET on the instance returning status 'running', or the neo4j+s connection URI check), since the skill defers cypher-shell to neo4j-cli-tools-skill.

DimensionReasoningScore

Conciseness

The body is dense with commands and tables rather than concept explanations — 'aura-cli credential add --name ... --client-id ...', the full poll_status function, and a Common Errors table with fixes — and it correctly delegates time-sensitive docs to a WebFetch table. However, ~90 lines of region-code tables and a six-row tier table are inlined even though references/aura-tiers.md already covers tier detail, so some content could be trimmed or moved. This fits anchor 4 ('Efficient; minor instances... that could be trimmed') better than 5 ('every token earns its place') and clearly better than 3, since there is no over-explanation of concepts Claude already knows.

4 / 5

Actionability

Nearly everything is copy-paste executable: complete bash for auth/token/create/poll (poll_status with timeout, destroying-state detection, and .gitignore guard), a full working Python provisioning script with error handling, Terraform HCL, and a concrete error→cause→fix table ('429 Too Many Requests | Rate limit hit (25 req/min Free...) | Add time.sleep(2) between polling calls'). Matches anchor 5 'Fully executable; copy-paste ready... specific examples cover the common cases'. A minor wrinkle — Step 4 verifies with cypher-shell, which the skill says belongs to another skill — does not create a real gap in coverage.

5 / 5

Workflow Clarity

Steps are explicitly sequenced (List Tenants → Create → Poll Until RUNNING → Write .env and Verify → Lifecycle Ops) with a validation checkpoint after every async operation (poll_status to a target state, 'Do NOT attempt connection... until status = running'), a status lifecycle diagram, error-recovery feedback (Common Errors table, 403 → re-run get_token(), Retry-After handling), and a final checklist. The destructive delete operation is guarded ('IRREVERSIBLE. Export snapshots first'; 'Delete confirmed by user — data loss is permanent'), so the destructive-operation cap at 3 does not apply. This matches anchor 5 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists'.

5 / 5

Progressive Disclosure

The body has good section structure, but the four provided bundle files (references/aura-tiers.md, aura-agent.md, aura-monitoring.md, data-importer.md) are never mentioned or linked anywhere in SKILL.md — they are orphaned and undiscoverable — while tier and region detail that duplicates references/aura-tiers.md is inlined. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline'). Not 4 because the references are entirely unsignaled rather than 'mostly clear'; not 2 because the body itself is well-sectioned, not a minimal-structure wall of text.

3 / 5

Total

17

/

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.

An exemplary description: concrete actions, explicit 'Use when' triggers, comprehensive natural terminology, and explicit out-of-scope disambiguation pointing to adjacent skills. It uses third-person voice and carries no filler despite its length.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'creating, pausing, resuming, resizing, or deleting AuraDB Free/Professional/Business Critical/VDC instances; downloading credentials; scripting CI/CD pipelines; polling async status' — plus concrete supporting topics (OAuth2 client credentials, region codes, Terraform provider). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it is above anchor 4 because coverage of the domain's operations is exhaustive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers 'what' ('Provisions and manages Neo4j Aura instances via CLI (aura-cli v1.7+) or REST API') and 'when' ('Use when creating, pausing, resuming, resizing, or deleting...') with concrete trigger phrases, and adds explicit negative scope ('Does NOT handle Cypher queries — use neo4j-cypher-skill'). This is a textbook match for anchor 5; anchor 4 would require the 'when' clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases are comprehensive: 'Neo4j Aura', 'AuraDB', tier names users would say ('Free', 'Professional', 'Business Critical', 'VDC'), operation verbs ('create', 'pause', 'resize', 'delete'), 'credentials', 'CI/CD pipelines', 'Terraform neo4j-labs/neo4jaura provider'. This matches anchor 5's 'comprehensive coverage of natural terms including synonyms' — users would naturally say nearly all of these when they need this skill. Not a 4 because no common variation (CLI vs REST vs Python vs Terraform entry points) is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (Aura instance lifecycle management) and it explicitly disambiguates three adjacent skills ('Does NOT handle Cypher queries — use neo4j-cypher-skill'; 'Does NOT cover Graph Data Science'; 'Does NOT cover neo4j-admin/cypher-shell — use neo4j-cli-tools-skill'). Minimal conflict risk, matching anchor 5 'Clear niche with distinct triggers'.

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.

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-provisioning-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.