CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

67

Quality

80%

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

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

Highly actionable, well-structured operational content: concrete commands with conditional branches, a failure checklist, safety gates, and a debug feedback loop. The only refinements are de-duplicating the repeated harness-push notes, moving post-repair verification into the checklist, and externalizing detail if the file grows.

DimensionReasoningScore

Conciseness

The body is dense operational guidance with no teaching of known concepts — every section adds MemFS-specific rules Claude could not infer. Minor trims exist: the "harness pushes after the turn" note repeats across three sections, and the intro's memory-worker protocol paragraph is long. Not a 5 due to this repetition; well above the verbosity of a 3.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `git -C "$MEMORY_DIR" status --short --branch`, `letta memory pull --agent "$AGENT_ID"`, `GIT_EDITOR=true git -C "$MEMORY_DIR" rebase --continue`, plus the `/memfs` and `/memory-repository` commands. Conditional variants cover both merge and rebase states, so the common cases are fully covered.

5 / 5

Workflow Clarity

Scenario-organized sections, a 7-step Failure Checklist, conditional branching on the in-progress Git operation, approval gates for destructive actions, and a `LETTA_DEBUG=1` retry loop. Just below a 5: post-repair verification ("verify the result before reporting success") appears only in the intro rather than as an explicit checklist or workflow step, leaving a minor validation gap.

4 / 5

Progressive Disclosure

No bundle files exist; the skill is self-contained with clear per-scenario section headers and no buried or nested references. Structure is good but the ~180-line single file keeps it at 4 rather than 5 — layout rules or the backup-remote section could be externalized if the file grows.

4 / 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 strong third-person description: concrete capabilities, a distinct niche, and explicit (negative-form) trigger guidance. The only improvement would be adding a positive "Use when…" clause with the natural phrases a user would say when their memory repo breaks.

DimensionReasoningScore

Specificity

"Diagnose and repair" applied to five named failure areas (repository setup, remote sync, authentication failures, backup remotes, merge/rebase conflicts) lists several specific capabilities with minor gaps — no concrete per-area actions. It lists domains rather than the comprehensive set of distinct concrete actions required for a 5.

4 / 5

Completeness

The "what" is explicit (diagnose and repair the enumerated failure classes) and the "when" is given as explicit negative trigger guidance ("Do not load for routine memory reads or edits") that clearly delimits loading. Not a 5 because no positive "Use when…" trigger phrase names the activating situations directly.

4 / 5

Trigger Term Quality

"remote sync", "authentication failures", "merge/rebase conflicts", "repository setup" are natural phrases a user with a broken memory repo would say. A few common variants are missing (e.g., "push rejected", "git error", "memory not syncing"), which keeps it below comprehensive coverage at 5.

4 / 5

Distinctiveness Conflict Risk

"MemFS repository" is a clear niche and the explicit exclusion of routine memory reads/edges distinguishes it from generic memory skills, so it is unlikely to trigger for the wrong skill.

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
letta-ai/letta-code
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.