CtrlK
BlogDocsLog inGet started
Tessl Logo

neo4j-getting-started-skill

Orchestrates zero-to-running-app in 8 stages — prerequisites → context → provision → model → load → explore → query → build. Each stage reads its own reference file. Supports HITL and fully autonomous operation. Use when starting a new Neo4j project from scratch, provisioning Aura, generating synthetic data, building a notebook or app, or running the full onboarding pipeline. Time budget ≤15 min autonomous, ≤90 min HITL. Does NOT cover Cypher query authoring — use neo4j-cypher-skill. Does NOT cover driver upgrades or Cypher migration — use neo4j-migration-skill. Does NOT cover CLI/admin tasks on an existing DB — use neo4j-cli-tools-skill.

91

1.69x
Quality

92%

Does it follow best practices?

Impact

90%

1.69x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

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 covers all key dimensions thoroughly. It provides specific concrete actions, natural trigger terms, explicit 'Use when' guidance, and outstanding distinctiveness through explicit exclusion clauses referencing sibling skills. The description uses proper third-person voice throughout and avoids vague language or buzzwords.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: provisioning Aura, generating synthetic data, building a notebook or app, running the full onboarding pipeline, and names 8 distinct stages (prerequisites, context, provision, model, load, explore, query, build).

3 / 3

Completeness

Clearly answers both 'what' (orchestrates zero-to-running-app in 8 stages with specific capabilities) and 'when' (explicit 'Use when...' clause listing five trigger scenarios). Also includes explicit exclusions pointing to other skills, which strengthens the 'when' guidance.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Neo4j project', 'provisioning Aura', 'synthetic data', 'notebook', 'app', 'onboarding pipeline', 'new Neo4j project from scratch'. These cover the main ways a user would phrase requests for this workflow.

3 / 3

Distinctiveness Conflict Risk

Exceptionally distinctive — explicitly delineates boundaries by naming three other skills it does NOT cover (neo4j-cypher-skill, neo4j-migration-skill, neo4j-cli-tools-skill), creating very clear niche separation and minimizing conflict risk.

3 / 3

Total

12

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-architected orchestration skill that excels at workflow clarity and progressive disclosure, with a clear 8-stage pipeline, explicit validation gates, resumability via progress.md, and one-level-deep references to stage-specific files. Actionability is strong with concrete file paths, commands, and completion criteria. The main weakness is that the body includes lengthy templates (README, final summary output) that could be moved to reference files to improve conciseness, as the skill is quite long for an orchestration overview.

Suggestions

Move the README.md template and final conversation summary template to separate reference files (e.g., references/templates/readme-template.md and references/templates/final-summary.md) to reduce the SKILL.md body length and improve conciseness.

DimensionReasoningScore

Conciseness

The skill is quite long (~300+ lines) with substantial template content (README template, final summary template) that could be in separate reference files. The progress tracking format, project structure, and final summary sections are detailed and necessary but the README template and conversation output template inflate the body significantly. Some sections like 'When to Use / When NOT to Use' are efficient, but the overall document could be tightened by moving templates to reference files.

2 / 3

Actionability

The skill provides highly concrete, executable guidance: specific file paths, exact bash commands (grep for resumption), precise completion conditions (node count ≥ 50, ≥5 queries), explicit project structure with filenames, and copy-paste ready templates. The success gates table with specific Cypher queries and the fast paths table give unambiguous decision criteria.

3 / 3

Workflow Clarity

The 8-stage pipeline is clearly sequenced with explicit dependencies, skip conditions, completion gates, and a resumability mechanism via progress.md. Each stage has a defined purpose, reference file, completion condition, and skip condition. The success gates table provides 7 explicit validation checkpoints. Error recovery is delegated to stage reference files. The HITL vs autonomous detection logic is precise.

3 / 3

Progressive Disclosure

The skill exemplifies progressive disclosure: the body is an orchestration overview that delegates detailed instructions to `references/<stage-name>.md` files (one level deep), with shared capabilities in `references/capabilities/`. The instruction to 'only load the stage you are currently executing — not all at once' is excellent token management. Navigation is clear with consistent reference patterns. However, no bundle files were provided to verify the referenced paths actually exist, but the structure is well-designed.

3 / 3

Total

11

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

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.