CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-ontology-skill

Author and validate Neo4j Ontology Graph Specification (ontology graph spec) documents. Use when writing or editing an ontology, defining nodes and relationships with properties, Neo4jType data types, constraints (key/unique/must_exist), labels, and endpoint cardinality, in YAML or JSON, or validating an ontology document against the live-resolved spec schema. Does NOT handle Cypher or loading an ontology into a database — use neo4j-cypher-skill. Does NOT cover generic graph data modeling advice — use neo4j-modeling-skill.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

The body is a lean, highly actionable authoring workflow: concrete commands with exit-code semantics, a complete minimal example, an explicit validate-fix-revalidate loop with a checklist, and clean one-level-deep reference splitting. The only imperfection is the Spec Status section, which restates schema-resolution/fallback details from Step 3 and includes transitional status notes that could be consolidated.

DimensionReasoningScore

Conciseness

Core Facts and the minimal example are dense and spec-specific with zero padding of concepts Claude already knows (e.g., "Absent means none — never write empty maps/lists...; omit them"). Not 5: the "Spec Status" section partially duplicates the schema-resolution and fallback details already given in Step 3 and carries time-sensitive transitional notes ("ONT-31", "transitional repo raw fallback") that could be trimmed or folded into Step 3.

4 / 5

Actionability

Fully executable guidance: exact commands for both invocation contexts ("uv run scripts/validate.py <document.{yaml,yml,json}>" from skill directory or repo root), exit-code semantics (0/1/2), and a complete copy-paste-ready minimal YAML example covering the common case. Schema resolution order is stated precisely.

5 / 5

Workflow Clarity

Four clearly sequenced steps with an explicit validation checkpoint and feedback loop ("Fix every reported error; re-run Step 3. Repeat until exit 0. Validation is MANDATORY — never present an ontology as done with a non-zero exit"), plus a final checklist. Matches the anchor-5 pattern of validate→fix→retry with a checklist.

5 / 5

Progressive Disclosure

Core facts and a minimal example stay inline; the bulk detail is split one level deep into a real references/format-reference.md (verified present, no nested references), signaled both in Step 2 ("Load references/format-reference.md when anything beyond the minimal example is needed") and in the References section with per-file content descriptions. Navigation is easy.

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 strong description: third-person voice, concrete multi-action capability statement, an explicit "Use when" trigger clause with specific authoring/editing/validating triggers, and explicit out-of-scope boundaries that disambiguate sibling skills. The only gap is minor — no file extensions and a few natural synonyms for trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Author and validate", "writing or editing an ontology, defining nodes and relationships with properties, Neo4jType data types, constraints (key/unique/must_exist), labels, and endpoint cardinality, in YAML or JSON" — comprehensively covering the skill's task space. Not 4: no minor gaps in coverage of the author/validate workflow are evident.

5 / 5

Completeness

Explicitly answers both: what ("Author and validate Neo4j Ontology Graph Specification (ontology graph spec) documents") and when ("Use when writing or editing an ontology, defining nodes and relationships... or validating an ontology document against the live-resolved spec schema"). Matches the anchor-5 pattern of concrete trigger phrases attached to both halves.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("ontology", "nodes", "relationships", "properties", "constraints", "cardinality", "YAML or JSON", "validating", plus the synonym "ontology graph spec") that users would naturally say. Not 5: file extensions (.yaml/.yml/.json) and a few common phrasings like "graph data model" are absent, though formats are named.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Neo4j Ontology Graph Specification documents) with explicit negative boundary routing to siblings ("Does NOT handle Cypher or loading an ontology into a database — use neo4j-cypher-skill. Does NOT cover generic graph data modeling advice — use neo4j-modeling-skill"). Minimal conflict 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.

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