CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

90%

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

100%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 exemplary lean reference: one fully executable wiring example, an exact adapter contract, concrete per-adapter scope semantics, explicit scope-security validation, and precise failure-mode/devtools behavior — all at ~110 lines with zero padding. Every dimension lands at the top anchor.

DimensionReasoningScore

Conciseness

The body is lean throughout: a three-line orientation, a clear 'do NOT use for within-turn history' disambiguation, and dense package-specific facts on every section (adapter scope mappings like hindsight's '{tenant|_}__{user}__{threadId}' bank format, mem0's user_id/run_id, devtools payload contents). It assumes Claude's competence and never explains generic concepts; nothing is trimmable, so the level 4 'minor instances of over-explanation' anchor does not fit.

5 / 5

Actionability

The wiring example is a complete, copy-paste-ready POST handler with real imports, server-side session resolution, and middleware options ('role', 'onRecall'/'onSave'); the MemoryAdapter interface shows exact signatures and return shapes ('{ systemPrompt, fragments?, tools?, toolGuidance? }'), and custom adapters get a concrete verification path via 'runMemoryAdapterContract from @tanstack/ai-memory/testkit'. No gaps remain for the level 4 anchor.

5 / 5

Workflow Clarity

The single wiring action is unambiguous via the executable example, and the sequence is explicit: resolve session server-side, derive scope, recall before the model runs, defer save after the turn. An explicit validation checkpoint is present ('validate it belongs to the session user BEFORE using it'), error recovery is specified (non-fatal 'memory:error', streaming never blocked), and the testkit provides verification — satisfying the simple-skill exception with no validation gaps.

5 / 5

Progressive Disclosure

The skill is self-contained with no bundle files, and nothing inlined clearly belongs in a separate file: ~110 cohesive lines of reference that would lose value if split. Section headers ('Wire it up', 'The contract', 'Scope security', 'Adapters', 'Failure modes', 'Devtools') make navigation trivial, and the one cross-reference ('see the in-memory skill') is clearly signaled.

5 / 5

Total

20

/

20

Passed

Description

76%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 highly specific, comprehensive description with an explicit 'Use when' trigger and near-zero conflict risk, held back only by trigger-term quality: it speaks in package jargon rather than the natural phrases users would say when they need persistent memory. Broadening the when-clause beyond the single wiring scenario would raise completeness as well.

Suggestions

Add natural trigger phrases users would actually say, e.g. 'remember what I told you last time', 'persistent memory across sessions', or 'cross-session recall', alongside the package-specific terms.

Broaden the when-clause to cover related scenarios beyond initial wiring — e.g. 'or when choosing a memory adapter (mem0, Honcho, Hindsight, Redis) or securing memory scope server-side'.

DimensionReasoningScore

Specificity

Every clause is concrete: 'wiring memoryMiddleware from @tanstack/ai-memory into a chat() call', 'recall/save adapter contract', 'scope shape and server-side scope security', 'choosing an adapter (inMemory, redis, hindsight, mem0, honcho)', and 'devtools events'. The enumeration covers the skill's full scope with no vague language, matching the comprehensive-coverage anchor rather than the 'minor gaps' level 4 anchor.

5 / 5

Completeness

Both what and when are explicitly present: 'Use when wiring memoryMiddleware from @tanstack/ai-memory into a chat() call' plus a comprehensive enumeration of covered topics. However the when-clause is a single narrow trigger phrase, whereas the level 5 anchor expects concrete trigger phrases spanning the range of use cases (e.g. adapter selection, securing scope, adding persistent memory).

4 / 5

Trigger Term Quality

Relevant keywords exist ('memoryMiddleware', '@tanstack/ai-memory', 'chat()', 'adapter') but they are package-specific jargon; the natural phrases a user would actually say ('remember what I told you last time', 'persistent memory across sessions', 'cross-session recall') are absent. This fits 'some relevant keywords but missing common variations or synonyms' rather than level 4's good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The description names a specific package and a specific middleware, giving it a clear niche with distinct triggers; the only conceivable overlap is with other TanStack AI skills, which the package identifier disambiguates. Minimal conflict risk.

5 / 5

Total

17

/

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

Path

packages/ai-memory/skills/tanstack-ai-memory/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.