CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

82

1.73x
Quality

88%

Does it follow best practices?

Impact

90%

1.73x

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

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strongly actionable orchestrator body: exemplary stage sequencing, per-stage validation gates, resumability protocol, and copy-paste-ready commands. Its weaknesses are duplicated stage conditions across Success Gates/Checklist/Fast Paths, the inline README template, and one orphaned reference file.

Suggestions

Move the README.md template and final summary print block (lines 286-420) into references/7-build.md — they are only used at the final stage and add ~130 lines to SKILL.md's always-loaded context.

De-duplicate stage conditions: keep 'Completes when' on each stage and drop the redundant Success Gates table rows / Checklist items that restate them verbatim, or vice versa; likewise merge the Fast Paths table with the per-stage skip conditions.

Reference quick-reference.md from SKILL.md (or a relevant stage file) so it is discoverable — it currently exists in the bundle but is linked from nowhere.

DimensionReasoningScore

Conciseness

The body is directive and table-driven rather than explanatory (no concept explanations Claude already knows), but systematic duplication adds avoidable tokens: each stage's 'Completes when' condition is restated nearly verbatim in the Success Gates table (lines 241-252) and again in the Checklist (lines 424-432), skip conditions appear both in the Stages section and the Fast Paths table (lines 255-262), and the ~130-line README template plus final print block (lines 286-420) is inlined in SKILL.md although it is used only once, at the very end. Not 4 because the trimming opportunities are systematic rather than 'minor instances'; not 2 because most sections are tight and every line carries instructions.

3 / 5

Actionability

Guidance is fully executable: the resume command 'grep -B1 "^status: pending" progress.md | grep "^###" | head -1', the exact progress.md format, concrete gates like '`MATCH (n) RETURN count(n)` ≥ 50', and a complete README template with copy-paste-ready cypher-shell/venv/pip commands. Conditional variations are explicitly handled ('Omit data/generate.py row when DATA_SOURCE=csv').

5 / 5

Workflow Clarity

The 8 stages run in explicit numbered order (0-prerequisites → … → 7-build) with a per-stage execution protocol (announce → read → execute → verify completion condition → update progress.md → proceed), explicit skip conditions, fast paths, error-recovery guidance ('If a stage fails, recover using the error guidance in the stage reference file'), 7 success gates, and a final checklist. Validation is present at every stage, so the destructive reset.cypher operation is properly gated — no cap applies.

5 / 5

Progressive Disclosure

Each stage links its own references/<stage>.md (all 8 verified to exist) with an explicit lazy-load instruction ('Only load the stage you are currently executing — not all at once'), and capabilities files are clearly signaled. Held below 5 because references/quick-reference.md is orphaned (referenced from neither SKILL.md nor any stage file), the ~130-line final-summary/README template is inlined in SKILL.md instead of living in the 7-build reference, and some content sits two levels deep (e.g., 7-build.md → capabilities/kg-from-documents.md). Not 3 because the vast majority of content is appropriately split with clear one-level navigation.

4 / 5

Total

17

/

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.

An exemplary description: concrete staged capabilities, an explicit 'Use when' trigger clause, time budgets, and explicit boundary exclusions redirecting to sibling skills. The only gap is a few missing natural trigger synonyms such as 'get started with Neo4j' or 'set up a graph database'.

DimensionReasoningScore

Specificity

Multiple concrete actions with comprehensive coverage: 'Orchestrates zero-to-running-app in 8 stages — prerequisites → context → provision → model → load → explore → query → build', 'provisioning Aura, generating synthetic data, building a notebook or app, or running the full onboarding pipeline'. Written in third person ('Orchestrates'). Not 4 because coverage spans every pipeline stage with no meaningful gaps.

5 / 5

Completeness

Explicitly answers both: what ('Orchestrates zero-to-running-app in 8 stages…') and when ('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'), plus explicit NOT-cover boundaries. Not 4 because the when-clause is explicit and concrete, not merely present-but-imprecise.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'starting a new Neo4j project from scratch', 'provisioning Aura', 'generating synthetic data', 'building a notebook or app', 'full onboarding pipeline'. Not 5 because common variations users would say are absent — e.g., 'get started with Neo4j', 'set up a graph database', 'load/import data'; not 3 because the phrases present are natural and well beyond generic keywords.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Neo4j from-scratch onboarding) with three explicit exclusions redirecting to sibling skills: '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'. Minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 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

14

/

16

Passed

Repository

neo4j-contrib/neo4j-skills

Path

neo4j-getting-started-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.