CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

syncing-memory-filesystem

Diagnose and repair MemFS repository setup, remote sync, authentication failures, optional backup remotes, or merge/rebase conflicts. Do not load for routine memory reads or edits.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 troubleshooting skill body: executable commands throughout, an explicit validation checklist with error-recovery steps, and tight domain-specific explanations with no filler. Remaining improvements are minor — trimming repeated statements and potentially offloading the backup-remote section to a reference file.

DimensionReasoningScore

Conciseness

The body is dense and imperative with commands instead of prose, and it explains only Letta/MemFS-specific behavior Claude would not know (layouts, harness push timing, enable flow side effects). It does not reach 5 because a few points are repeated (the rule to leave pushes to post-turn harness sync appears in three sections, and the credential-redaction warning appears twice), which could be trimmed.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready commands such as `/memfs enable`, `letta memory pull --agent "$AGENT_ID"`, `git -C "$MEMORY_DIR" status --short --branch`, the sed-based URL redaction, `GIT_EDITOR=true git -C "$MEMORY_DIR" rebase --continue`, and `/memory-repository set git@github.com:you/my-memory.git` cover the common cases. The only placeholder (`<resolved-memory-path>`) is appropriately situational, matching the score 5 anchor.

5 / 5

Workflow Clarity

The content is organized as a clear diagnostic sequence (harness commands first, then checkout inspection, uncommitted changes, conflicts, backup remote) and closes with an explicit seven-step Failure Checklist that includes validation checkpoints (confirm `$MEMORY_DIR`, check backend type, inspect git status) and an error-recovery feedback loop ("rerun it with `LETTA_DEBUG=1` and report the redacted error"), plus safety guardrails ("Do not reset, abort, or discard either side without the user's approval"). This matches the score 5 anchor with its checklist and feedback loop.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers, one level of depth, and no buried or nested references (no bundle files exist, and every internal reference is to a named skill or command). It does not reach 5 because at ~175 lines all content is inline; sections like the Optional Backup Remote could plausibly live in a separate reference file, fitting the score 4 anchor of good structure with minor organization gaps.

4 / 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, concise description: concrete actions, a comprehensive enumeration of failure modes, and an explicit exclusion clause that reduces conflict risk. Its main weakness is the absence of a positive 'Use when...' trigger clause, leaving the 'when' to be inferred from the negation.

Suggestions

Add a positive trigger clause, e.g., 'Use when MemFS fails to initialize, memory stops syncing, pulls/pushes fail with auth errors, or a memory merge/rebase conflict appears.'

Include one or two natural user phrasings as trigger terms (e.g., 'memory not syncing', 'push rejected') to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description names concrete actions ("Diagnose and repair") and enumerates a comprehensive list of specific failure targets: "repository setup, remote sync, authentication failures, optional backup remotes, or merge/rebase conflicts". This matches the anchor for multiple specific concrete actions with comprehensive coverage; it is not score 4 because there is no noticeable coverage gap within the skill's domain and no vague filler.

5 / 5

Completeness

The 'what' is clear (diagnose and repair MemFS repository problems) and there is explicit trigger guidance in the negative clause "Do not load for routine memory reads or edits", which delimits when to load it. It does not reach 5 because there is no positive 'Use when...' clause with concrete trigger phrases, only an exclusion; it exceeds 3 because the 'when' is explicitly addressed rather than merely implied.

4 / 5

Trigger Term Quality

Natural phrases a user would say during troubleshooting are present ("repository setup", "remote sync", "authentication failures", "merge/rebase conflicts"), giving good keyword coverage. It falls short of the score 5 anchor because a few natural variants users would actually say are missing (e.g., "memory not syncing", "push rejected", "pull fails").

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (MemFS repository repair) with distinct triggers, and the exclusion clause "Do not load for routine memory reads or edits" actively prevents conflict with ordinary memory-editing skills. Minimal conflict risk, matching the score 5 anchor.

5 / 5

Total

18

/

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

letta-ai/letta-code

Path

src/skills/builtin/syncing-memory-filesystem/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.