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

81%

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

78%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 strong, information-dense configuration skill: executable diagnostic commands throughout, a well-guarded change workflow with explicit verification and safety checkpoints, and exemplary platform-based progressive disclosure into real one-level-deep reference files. The main improvements are deduplicating the repeatedly-stated project-config trust rules and adding one concrete 'memsearch config set' example.

Suggestions

State the trusted-vs-allowlisted project-config rule once (e.g., in 'Configuration Logic') and reference it elsewhere instead of repeating it at lines 129-138, 201, and 217; likewise state the 'not the host agent's memory system' disambiguation only at the top.

Add a concrete example of the most common operation, e.g., 'memsearch config set plugins.claude-code.project_review.enabled true' (global, no --project) and 'memsearch config set --project indexing.ignore_files [".gitignore"]', since set-command syntax is never shown.

Move the 'Since v0.4.11' compatibility notes into a short 'Old behavior / compatibility' subsection so time-sensitive version details don't interrupt the current-behavior flow.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious MemSearch specifics (allowlisted project keys, config resolution order, state-file meanings) and assumes Claude's competence, with no padding about concepts Claude already knows. It is not a 5 because the trusted-keys/project-scope rule is restated several times ('Do not write plugin automation keys with --project; v0.4.11+ project config ignores or rejects them' repeats lines 129-138 and 144), the 'not the host agent's memory system' statement appears twice (opening and line 219), and inline version references ('Since v0.4.11') sit outside any deprecated/old-patterns section — while a 3 would underrate a body where nearly all content is MemSearch-specific.

4 / 5

Actionability

Nearly everything is executable: copy-paste bash for diagnostics ('memsearch config list --resolved', 'memsearch stats', index-state inspection), complete TOML provider blocks, and explicit flag guidance ('Use --project only for allowlisted local indexing keys'). It falls short of 5 because the core operation — changing a setting — never shows a concrete 'memsearch config set <key> <value>' invocation with and without --project, leaving the most common case as description rather than example; 3 would require pseudocode or missing key details, which is not the case.

4 / 5

Workflow Clarity

A clear implicit sequence runs platform detection (with environment markers) → intent routing → 'Diagnose First' → configuration logic → 'Applying changes', with explicit checkpoints: ask-before-destructive list ('Ask the user before enabling external or paid providers, ... re-indexing, deleting state'), post-change verification ('After changing anything, show the command, the resolved value, and whether a new session is needed'), and error-recovery inspection of index-state and maintenance-state files. It is not a 5 because no single end-to-end numbered procedure ties these together — the reader assembles the flow from sections — though checkpoints are too explicit for a 3.

4 / 5

Progressive Disclosure

Platform-specific detail is split into five real one-level-deep reference files (references/claude-code.md, codex.md, openclaw.md, opencode.md, dsh.md — all present in the bundle), clearly signaled with 'Read ONLY the one file matching your current environment' plus environment markers for discovery, while shared logic stays inline. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'; there is no nesting beyond one level and no buried references.

5 / 5

Total

17

/

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 well-constructed description with an explicit 'Use when' clause backed by a comprehensive list of concrete trigger topics, clearly anchored to the named MemSearch product. Its main weaknesses are the thin two-verb capability statement and minor overlap risk with generic memory/config tooling phrasing.

Suggestions

Expand the 'what' clause beyond two verbs to name several specific capabilities, e.g., 'Diagnose and configure MemSearch memory behavior: route LLM providers and models, override prompt files, enable plugin summarization and PROJECT.md/USER.md maintenance, and manage index health.'

Add natural user phrasing variations users would actually say, such as 'memory search', 'recall returns nothing', 'settings', or '.memsearch directory', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("MemSearch memory behavior") and exactly two concrete actions ("Diagnose and configure"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not list several specific actions (e.g., tuning provider routing, overriding prompts, enabling plugin tasks), and not a 2 because the actions are domain-anchored rather than generic.

3 / 5

Completeness

Both questions are answered explicitly: what ("Diagnose and configure MemSearch memory behavior") and when ("Use when the user asks about ... index health, provider routing, prompt files, or migration/compatibility questions") with a concrete list of trigger phrases. This directly matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; a 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Strong natural keyword coverage: "MemSearch configuration, plugin summarization, PROJECT.md/USER.md maintenance, memory directories, index health, provider routing, prompt files, or migration/compatibility questions" — terms users would plausibly say. It falls short of 5 because common variations like "memory search", "recall", "settings", or ".memsearch" are absent, and exceeds 3 because coverage spans multiple distinct sub-topics rather than a few generic keywords.

4 / 5

Distinctiveness Conflict Risk

The named-product framing ("MemSearch") gives it a clear niche with distinct triggers, but terms like "memory directories", "provider routing", and "prompt files" overlap with host-agent memory/LLM-configuration skills — the body itself acknowledges this confusion risk. This fits 'Mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

zilliztech/memsearch

Path

plugins/openclaw/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.