CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-config

Diagnose and configure MemSearch memory behavior. Use when the user asks about MemSearch configuration, plugin summarization, PROJECT.md/USER.md maintenance, memory directories, index health, provider routing, prompt files, or migration/compatibility questions.

Quality

87%

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

The canonical home for this skill is memory-config in zilliztech/memsearch

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-engineered configuration skill: executable commands, explicit trusted-vs-project config boundaries, error-state feedback loops, and clean per-platform progressive disclosure. Its main gaps are mild redundancy in the ask-first/disclaimer guidance and an implicit rather than explicitly sequenced top-level workflow.

Suggestions

Consolidate the two ask-first passages (Intent Routing and the pre-advanced-maintenance checklist) into one safety section to remove redundancy.

Add a brief numbered top-level flow (route intent → pick platform file → diagnose → apply → verify/report) so the section order is explicit.

Move version-pinned model defaults (gpt-5-mini, claude-sonnet-4-6, gemini-3-flash-preview) into platform reference files or a single compatibility table to keep the overview lean.

DimensionReasoningScore

Conciseness

The body is dense with novel MemSearch-specific facts (config resolution rules, trusted-key allowlists, state-file semantics) and wastes no tokens explaining concepts Claude already knows. Minor trimmable redundancy: the ask-first guidance appears at both the Intent Routing section and again more specifically before enabling advanced maintenance, and the host-agent disclaimer is stated twice. Not 5 due to these repetitions and some version-pin details (v0.4.11, specific model IDs) that could be consolidated.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `memsearch config list --resolved/--global/--project`, the version-check pipeline with `uv tool list` and the PyPI JSON query, the `MDIR` memory-file inspection block, index/maintenance state-file checks, and concrete TOML provider blocks. Scope rules for `config set` (global vs `--project` allowlisted keys) and post-change verification guidance cover the common cases.

5 / 5

Workflow Clarity

A clear sequence is present — intent routing, "Diagnose First" with ordered commands, platform reference selection, then apply-and-report — with real validation checkpoints ("show the command, the resolved value, and whether a new session is needed") and error-recovery loops via `.index-state.json` status/`last_error` and `.maintenance-state.json`. Not 5 because the overall ordering across sections is implicit rather than an explicit numbered flow, and the diagnose-then-configure progression must be assembled by the reader.

4 / 5

Progressive Disclosure

Platform-specific detail is appropriately split into five one-level-deep reference files (references/claude-code.md, codex.md, openclaw.md, opencode.md, dsh.md — all present in the bundle, none nesting further), with explicit navigation ("Read ONLY the one file matching your current environment") and environment-marker disambiguation. Shared configuration logic stays in the overview where it belongs, matching the anchor-5 structure.

5 / 5

Total

18

/

20

Passed

Description

83%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 with explicit what-and-when structure and mostly MemSearch-specific trigger terms. Its weaknesses are a thin action-verb list (only diagnose/configure), a few missing natural synonyms, and slight overlap risk with generic memory-skill triggers.

Suggestions

Add one or two more concrete capability verbs, e.g. "...diagnose and configure MemSearch memory behavior, route LLM providers, and check index health".

Include natural symptom phrases users would say, such as "search returns nothing", "memories not being captured", or "reindex/update MemSearch".

Qualify generic terms like "memory directories" with "MemSearch" to reduce overlap with the host agent's own memory-skill triggers.

DimensionReasoningScore

Specificity

"Diagnose and configure" names two concrete actions, and the enumerated scope ("index health", "provider routing", "prompt files", "migration/compatibility") broadens coverage beyond the 1-2-action anchor 3 example, though the action verbs themselves number only two. Not 5 because no additional specific actions (e.g., reindex, set providers, tune prompts) are stated as capabilities.

4 / 5

Completeness

"Diagnose and configure MemSearch memory behavior" clearly states what the skill does, and "Use when the user asks about..." explicitly lists concrete trigger phrases — matching the anchor-5 example structure exactly. Anchor 4 would require a weaker or less explicit 'when' clause, which this lacks.

5 / 5

Trigger Term Quality

"MemSearch configuration", "plugin summarization", "PROJECT.md/USER.md maintenance", "index health", and "provider routing" are natural terms a MemSearch user would say. Not 5 because common variations like "search/recall returns nothing", "reindex", or "update MemSearch" are missing.

4 / 5

Distinctiveness Conflict Risk

The MemSearch-specific terms (PROJECT.md/USER.md, index health, provider routing in this context) form a clear niche, but generic phrases like "memory directories" and "migration/compatibility questions" create minor overlap risk with host-agent memory/config skills — the body itself acknowledges this ambiguity. Not 5 because of that residual overlap; not 3 since most triggers are unambiguous.

4 / 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

zilliztech/memsearch

Path

plugins/_shared/skills/memory-config/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.