CtrlK
BlogDocsLog inGet started
Tessl Logo

tanstack-ai-memory

Use when wiring memoryMiddleware from @tanstack/ai-memory into a chat() call — covers the recall/save adapter contract, scope shape and server-side scope security, the recall-inject / deferred-save lifecycle, choosing an adapter (inMemory, redis, hindsight, mem0, honcho), and devtools events.

74

Quality

93%

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

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

An excellent, dense reference-style skill: executable wiring code, a precise adapter contract, hard security guidance (server-side scope resolution, never trust client ids), and non-obvious failure semantics. The only structural gaps are the absence of an explicitly ordered workflow with validation checkpoints and the choice to inline adapter/devtools detail that could be split into reference files.

DimensionReasoningScore

Conciseness

The body is lean and every section carries library-specific facts Claude cannot know (adapter contract, scope semantics, per-adapter key formats, failure behavior, devtools events). No padding or explanation of general concepts — comments in the code earn their place ("dev/tests only", "never from the request body").

5 / 5

Actionability

The wiring example is complete and copy-paste runnable (imports, session resolution, middleware config with server-side scope), the adapter contract is given as a concrete TypeScript interface with return shapes, and custom adapters get a concrete verification hook ("run runMemoryAdapterContract from @tanstack/ai-memory/testkit"). Common cases are covered.

5 / 5

Workflow Clarity

The flow (wire up → secure scope → pick adapter → know failure behavior) is clearly sequenced by section, and the testkit contract test plus the failure-modes section provide checkpoints. However, the sequence is implicit rather than an explicit ordered workflow with validation steps, matching 'clear sequence with most checkpoints present; minor validation gaps' rather than the explicit validate/re-validate loop at 5.

4 / 5

Progressive Disclosure

Sections are well-organized and there is no nested-reference problem; the one pointer ("see the in-memory skill") is clearly signaled. But at ~110 lines it exceeds the under-50-line simple-skill case, and per-adapter details plus devtools event payloads are inlined where a references/ file could carry the bulk — 'good structure; most content appropriately placed; minor organization gaps'.

4 / 5

Total

18

/

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: it states an explicit 'Use when' trigger tied to a concrete integration task and enumerates the specific capabilities covered. The only weakness is that trigger vocabulary is more technical than conversational — natural user phrasings for memory (persistent/cross-session/remember) are absent.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities: "wiring memoryMiddleware from @tanstack/ai-memory into a chat() call", "the recall/save adapter contract", "scope shape and server-side scope security", "the recall-inject / deferred-save lifecycle", "choosing an adapter (inMemory, redis, hindsight, mem0, honcho), and devtools events". Coverage is comprehensive across the skill's surface with no vague filler — well above the score-4 anchor's 'minor gaps' level.

5 / 5

Completeness

Both halves are explicit: "Use when wiring memoryMiddleware from @tanstack/ai-memory into a chat() call" answers 'when' with a concrete trigger, and the enumeration ("covers the recall/save adapter contract, scope shape and server-side scope security, ... lifecycle, choosing an adapter ..., and devtools events") answers 'what' concretely. This mirrors the top anchor's structure.

5 / 5

Trigger Term Quality

Trigger keywords are good and domain-accurate ("memory", "chat() call", "recall", "save", "memoryMiddleware", named adapters), but it leans on technical jargon and misses natural user phrasings like "persistent memory", "cross-session", or "remember what I told you". This matches the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The description is pinned to a specific package and middleware ("memoryMiddleware from @tanstack/ai-memory into a chat() call") with named competitor-free adapters, giving it a clear niche with essentially no overlap risk against generic memory or chat skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
TanStack/ai
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.