CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neo4j-agent-memory-skill

Authoritative reference for the neo4j-agent-memory Python package — a graph-native memory system for AI agents built on Neo4j — and for the hosted service (NAMS) at memory.neo4jlabs.com. Use this skill whenever the user mentions neo4j-agent-memory, agent memory with Neo4j, context graphs, the POLE+O model, MemoryClient/MemorySettings, the memory MCP server, or any of the framework integrations (LangChain, PydanticAI, CrewAI, AWS Strands, Google ADK, Microsoft Agent Framework, OpenAI Agents, LlamaIndex). Also use when the user mentions the hosted service at memory.neo4jlabs.com, NAMS, the Neo4j Agent Memory Service, the `nams_` API key prefix, or the hosted MCP endpoint. Also use when writing documentation, blog posts, tutorials, PRDs, or code samples for the project, when comparing agent memory approaches, or when positioning graph-native memory against vector-only approaches — even if the user doesn't explicitly name the package.

67

Quality

84%

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

71%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 high-quality reference skill: exceptionally concrete and copy-paste ready, with strong verify-before-citing discipline. Its weaknesses are redundancy (the NAMS warning and version-verification guidance repeated across sections, plus two overlapping checklists) and a fully monolithic structure with no progressive disclosure despite content that would split naturally into reference files.

Suggestions

Merge the 'Quick Authoritative-Facts Checklist' and the final 'Checklist' into a single pre-publish checklist, and state the NAMS early-access and verify-PyPI warnings once each — the repetition costs tokens without adding information.

Split stable, detail-heavy sections (Hosted Service/NAMS, Canonical Examples, Positioning Language, framework integration tables) into references/ files with one-level-deep links from SKILL.md, keeping the body as a navigable overview.

Consolidate the scattered verification guidance into one explicit draft → verify (PyPI / live NAMS + OpenAPI) → publish workflow so the checkpoints form a single sequence instead of repeated inline warnings.

DimensionReasoningScore

Conciseness

The body is dense and fact-only (no explanations of concepts Claude already knows), but it is noticeably tightable: the NAMS early-access warning appears four times (the intro callout, the NAMS section, correction #7, and both checklists), 'verify PyPI' is repeated five times, and the 'Quick Authoritative-Facts Checklist' and final 'Checklist' sections substantially duplicate each other. Inline time-sensitive values ('0.7.0 (2026-10-07)') sit outside any 'old patterns'/'deprecated' section, further taxing the token budget. This fits the 3 anchor (mostly efficient but could be tightened) better than 4, whose over-explanation would be only minor.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: a complete async quickstart ('async with MemoryClient(settings) as memory:'), one-liner 'uvx "neo4j-agent-memory[mcp]" mcp serve --password <neo4j-password>', 'claude mcp add' registration commands, Claude Desktop JSON configs, exact import paths ('neo4j_agent_memory.integrations.<framework>'), the full extras list, exact hex color codes, and upstream example URLs. The single '...' placeholder in the OpenAI Agents table row is the only gap and the common cases are fully covered — the 5 anchor, not the 4 anchor's 'minor gaps'.

5 / 5

Workflow Clarity

The reference task itself is unambiguous and carries real validation checkpoints — 'Verify authoritative state before writing' pointing to PyPI and the GitHub README, 're-check the live site and the OpenAPI spec' for NAMS, and pre-publish checklists. It lands at 4 rather than 5 because there is no sequenced workflow for the authoring tasks the skill supports (draft → verify → publish), the duplicated checklists blur which one governs, and the checkpoint guidance is repeated across sections instead of consolidated into one loop.

4 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so ~413 lines of content sit in a single monolithic SKILL.md. Section headers and tables make it navigable (above the 2 anchor), but content that clearly belongs in separate reference files — NAMS details, the canonical-examples catalog, positioning language, the framework integration table — is inlined, and there are no well-signaled one-level-deep references to reward. This matches the 3 anchor; the 4 anchor's 'references mostly clear' cannot apply when no references exist.

3 / 5

Total

15

/

20

Passed

Description

91%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: explicit what and when, comprehensive natural trigger terms including synonyms and unique identifiers, written in third person. The only softness is intentional breadth in the positioning/comparison triggers, which slightly raises conflict risk with generic agent-memory topics.

DimensionReasoningScore

Specificity

The description states a concrete what — 'Authoritative reference for the neo4j-agent-memory Python package — a graph-native memory system for AI agents built on Neo4j — and for the hosted service (NAMS) at memory.neo4jlabs.com' — and enumerates its coverage (MCP server, POLE+O model, MemoryClient/MemorySettings, eight named framework integrations). It lands at 4 rather than 5 because it enumerates subject-matter coverage rather than multiple distinct concrete actions the skill performs, and clearly exceeds the 3 anchor (domain plus concrete coverage, not just 1-2 actions).

4 / 5

Completeness

Both questions are answered explicitly: the what ('Authoritative reference for the neo4j-agent-memory Python package... and for the hosted service (NAMS)') and the when ('Use this skill whenever the user mentions...', 'Also use when the user mentions...', 'Also use when writing documentation, blog posts, tutorials, PRDs, or code samples...'). Concrete trigger phrases are attached to every when-clause, exactly matching the 5 anchor.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and includes synonyms and low-level identifiers users would naturally say: 'neo4j-agent-memory', 'agent memory with Neo4j', 'context graphs', 'the POLE+O model', 'MemoryClient/MemorySettings', 'the memory MCP server', 'NAMS', 'the Neo4j Agent Memory Service', "the `nams_` API key prefix", 'the hosted MCP endpoint', plus all eight framework names. This matches the 5 anchor (comprehensive natural terms including synonyms and variants) and is well above the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Unique identifiers (the package name, NAMS, the `nams_` prefix, memory.neo4jlabs.com) give it a clear niche with minimal conflict risk, but the deliberately broad triggers — 'when comparing agent memory approaches', 'when positioning graph-native memory against vector-only approaches — even if the user doesn't explicitly name the package' — create minor overlap risk with general agent-memory discussion and technical-writing skills. This fits the 4 anchor (mostly distinct, minor overlap risk) better than the 5 anchor (minimal conflict risk).

4 / 5

Total

18

/

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-agent-memory-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.