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. Does NOT handle GraphRAG pipelines — use neo4j-graphrag-skill.

Quality

82%

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

63%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 genuinely useful, fact-dense reference with strong executable examples and a clear verification ethos, but it pays for its breadth in token efficiency: inline version-sensitive data, duplicated checklists and URL lists, and no progressive disclosure of the large catalogs into separate files. Tightening the redundancies and splitting reference material would lift the weakest dimensions.

Suggestions

Merge the 'Quick Authoritative-Facts Checklist' and the final 'Checklist' into one pre-publish checklist, and fold the 'Resources' list into the 'Project at a Glance' table to eliminate duplicated URLs and checklist items.

Move time-sensitive data (current version, per-release notes like 'As of v0.1.1') into a single dedicated verify-versions section or reference file with concrete verification commands (e.g., checking PyPI), instead of scattering it inline.

Move the full extras catalog, canonical-examples listing, and NAMS API details into reference files under references/ and link to them from the body, turning SKILL.md into a lean overview.

DimensionReasoningScore

Conciseness

The body is fact-dense with no explanations of concepts Claude already knows, but inline time-sensitive data ('Current version (at time of writing) | 0.8.0 (2026-10-22)', 'As of v0.1.1', 'Deduplication (v0.1.1+)') is not confined to a deprecated/old-patterns section, and there is real duplication: two overlapping checklists ('Quick Authoritative-Facts Checklist' and 'Checklist'), URLs repeated between 'Project at a Glance' and 'Resources', and the lennys-memory URL stated twice.

3 / 5

Actionability

Mostly executable, copy-paste-ready guidance: install extras, the async MemoryClient quickstart, MCP serve and claude mcp registration commands, Claude Desktop JSON configs, and exact per-framework import paths. Minor gaps keep it below 5 — the integrations table gives imports with no usage snippet, and extraction config objects ('ExtractionConfig', 'DeduplicationConfig') are named without code.

4 / 5

Workflow Clarity

The authoring workflow is clearly sequenced with most checkpoints present: a 'Verify authoritative state before writing' warning up top, 'Common Corrections to Watch For', and an explicit pre-publish checklist. Not a 5 because the verification steps lack concrete commands (e.g., how to check PyPI) and the two overlapping checklists dilute the single canonical checkpoint.

4 / 5

Progressive Disclosure

Good internal section structure, but the skill is a ~420-line monolith with no bundle files: content that clearly belongs in separate reference files (the full extras catalog, the canonical-examples listing, NAMS details, the positioning guide) is all inlined, fitting anchor 3 rather than 4.

3 / 5

Total

14

/

20

Passed

Description

95%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: it states what the skill authoritatively covers, enumerates comprehensive natural trigger terms including identifiers and intent-level phrasings, and explicitly fences off the nearest competing skill. The only nit is that capability 'actions' are phrased as coverage areas rather than an explicit action list.

DimensionReasoningScore

Specificity

Names the domain and many specific artifacts ('MemoryClient/MemorySettings', 'the memory MCP server', framework integrations, NAMS, the 'nams_' API key prefix), but the concrete actions are scope areas of a reference ('writing documentation, blog posts, tutorials, PRDs, or code samples') rather than an explicit list of actions — minor gaps versus anchor 5.

4 / 5

Completeness

Explicitly answers both what ('Authoritative reference for the neo4j-agent-memory Python package… and for the hosted service (NAMS)') and when, with multiple concrete trigger clauses ('Use this skill whenever…', 'Also use when…') and an explicit exclusion ('Does NOT handle GraphRAG pipelines — use neo4j-graphrag-skill').

5 / 5

Trigger Term Quality

Comprehensive natural trigger coverage including the package name, 'agent memory with Neo4j', 'context graphs', 'the POLE+O model', every framework name, 'NAMS', the 'nams_' prefix, plus intent-level triggers like 'comparing agent memory approaches' and 'positioning graph-native memory against vector-only approaches'. No common variation is missing, matching the anchor-5 example's synonym-and-identifier coverage.

5 / 5

Distinctiveness Conflict Risk

Triggers are tied to one specific package and hosted service — a clear niche — and the explicit negative boundary for GraphRAG pipelines steers the most likely confusion case to a different skill, so conflict risk is minimal.

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