CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/codex/skills/memory-config/SKILL.md

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

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 well-engineered configuration skill: genuinely non-obvious domain knowledge, executable diagnostic commands, sensible safety guardrails, and an exemplary platform-file split for progressive disclosure. The biggest costs are token overhead from repeated platform-file pointers and disclaimer restatements, and the missing concrete syntax for the central "memsearch config set" operation.

Suggestions

Show one concrete "memsearch config set <key> <value>" example (e.g., enabling a provider globally vs an allowlisted project indexing key) so the primary configure action is fully executable without inference.

Consolidate the repeated "see your platform reference file" reminders into the one dedicated routing section and the Plugin keys section, cutting roughly five redundant restatements.

State the MemSearch-vs-host-memory disclaimer once (it currently appears in the intro, the Applying changes section, and the restart paragraph) and move version-dependent behavior (v0.4.11 project-config restrictions) into a single labeled compatibility section.

DimensionReasoningScore

Conciseness

The body is dense with MemSearch-specific facts Claude would not know, but it repeats the "see your platform reference file" pointer roughly six times, restates the not-host-memory disclaimer in three places, and inlines version-stamped details ("Since v0.4.11", "v0.4.11+") outside any compatibility/deprecated section. This is mostly efficient but could be meaningfully tightened, fitting anchor 3 rather than the minor-trim profile of anchor 4.

3 / 5

Actionability

Copy-paste-ready bash blocks for diagnosis ("memsearch config list --resolved", index-state inspection) and complete TOML provider examples make most guidance executable, and error-state semantics ("status: degraded" vs "status: error") are concrete. It falls short of anchor 5 because the core configure action never shows the actual "memsearch config set" invocation syntax (key/value form and flags), leaving the primary workflow's final step to inference.

4 / 5

Workflow Clarity

There is a clear sequenced flow — intent routing, diagnose-first with concrete commands, explicit scope choice (global vs project), then apply and verify ("After changing anything, show the command, the resolved value, and whether a new session is needed") — plus guardrails ("Ask the user before enabling external or paid providers... re-indexing, deleting state") and error-recovery pointers for silent index/maintenance failures. Not a 5 because the sequence is implied by section order rather than explicitly ordered, and the verify step is a single instruction rather than a validate-fix-retry loop.

4 / 5

Progressive Disclosure

The SKILL.md serves as a shared overview with all platform-specific detail correctly split into five real, one-level-deep reference files, each clearly signaled with a conditional read rule ("Read ONLY the one file matching your current environment") and environment markers for choosing. References were verified to exist and contain substantive content; navigation is easy and nothing is nested deeper than one level.

5 / 5

Total

16

/

20

Passed

Description

78%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 an explicit what/when structure and a concrete, well-scoped trigger list tied to the MemSearch niche. Its main weakness is a thin action inventory — only "diagnose" and "configure" — which undersells the specific operations the body actually covers.

DimensionReasoningScore

Specificity

"Diagnose and configure MemSearch memory behavior" names the domain plus exactly two concrete actions, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because the description never expands into the several specific operations the skill actually supports (index health checks, provider routing, plugin key toggling).

3 / 5

Completeness

It explicitly answers both questions: what ("Diagnose and configure MemSearch memory behavior") and when ("Use when the user asks about...") with a concrete list of trigger phrases. This matches the anchor-5 example pattern; anchor 4's caveat that the 'when' could be more explicit does not apply to such an explicit trigger list.

5 / 5

Trigger Term Quality

"MemSearch configuration, plugin summarization, PROJECT.md/USER.md maintenance, memory directories, index health, provider routing, prompt files, or migration/compatibility questions" gives good natural keyword coverage users would plausibly say. Not a 5 because common variations like "recall", "search returns nothing", or "vector index" are absent.

4 / 5

Distinctiveness Conflict Risk

The MemSearch brand plus distinct artifacts like "PROJECT.md/USER.md maintenance" and "index health" carve a clear niche, but "memory directories", "prompt files", and "migration/compatibility questions" are unbranded terms with minor overlap risk against host-agent memory/config skills. Not a 3 because the majority of triggers are clearly MemSearch-scoped; not a 5 because of those generic trailing terms.

4 / 5

Total

16

/

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