CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-aura-agent-skill

Manages Neo4j Aura Agents via the v2beta1 REST API — create, list, get, update, delete, and invoke Aura agents backed by an AuraDB instance. Use when configuring Aura Agent tools (CypherTemplate, SimilaritySearch, Text2Cypher), setting system prompts, deploying agents to REST or MCP endpoints, or invoking agents with natural language queries. Covers OAuth2 auth, organization/project scoping, tool parameter schemas, and InvokeAgentResponse format. Does NOT cover AuraDB instance provisioning — use neo4j-aura-provisioning-skill. Does NOT cover vector index creation — use neo4j-vector-index-skill.

74

Quality

92%

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

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.

A thorough, executable workflow skill with concrete commands and configs, strong validation/feedback checkpoints, and well-structured progressive disclosure into real bundle files. Only minor conciseness trims would improve it further.

DimensionReasoningScore

Conciseness

Dense, action-oriented content built from commands, tables, and complete config snippets with little padding; a few sections ('What are Aura Agents') could be trimmed slightly, keeping it just below fully lean.

4 / 5

Actionability

Copy-paste-ready bash commands, `uv run python3 scripts/...` invocations, and complete JSON configs with real field names cover the common cases (create, invoke, update, delete, direct curl).

5 / 5

Workflow Clarity

A clear 9-step sequence with explicit validation checkpoints ('Stop and report', data gate in Step 4), confirmation gates before destructive actions (Step 9), an error-recovery table, and a final checklist.

5 / 5

Progressive Disclosure

SKILL.md is an overview that signals one-level-deep references at the right moments (authoring-guide.md in Step 5, REFERENCE.md for embedding providers), with the bulk detail correctly split into the references/ and scripts/ bundle files that exist on disk.

5 / 5

Total

19

/

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 well-crafted description that concretely enumerates capabilities, provides explicit 'Use when' triggers, and clearly separates its scope from sibling Neo4j skills via negative boundary guidance. Minor room for additional natural-language synonyms in the trigger phrasing.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'create, list, get, update, delete, and invoke Aura agents' — plus configuring named tool types (CypherTemplate, SimilaritySearch, Text2Cypher), setting system prompts, and deploying to REST/MCP endpoints, giving comprehensive coverage.

5 / 5

Completeness

Explicitly answers both 'what' (manages Aura Agents via the v2beta1 REST API with enumerated CRUD+invoke actions) and 'when' (an explicit 'Use when...' clause with concrete triggers), plus negative boundary guidance.

5 / 5

Trigger Term Quality

Strong natural trigger phrases ('configuring Aura Agent tools', 'setting system prompts', 'deploying agents to REST or MCP endpoints', 'invoking agents with natural language queries'); a few synonymous phrasings a user might say are absent, keeping it just below comprehensive.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Neo4j Aura Agents on AuraDB) with explicit 'Does NOT cover' boundary pointers to sibling skills, minimizing overlap risk.

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.

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.