CtrlK
BlogDocsLog inGet started
Tessl Logo

editing-letta-code-desktop-preferences

Edits Letta Code Desktop (LCD) preferences by safely reading and updating ~/.letta/desktop_preferences.json. Use only when the user asks to change current Desktop/LCD settings such as theme, default working directory, remote access preference, or remote environment name via the preferences JSON.

76

Quality

95%

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

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

Excellent single-purpose skill body: executable merge-and-validate tooling, a precise key reference including system-managed keys not to touch, and a lean token footprint. The only gap is the absence of an explicit failure/recovery path after the validation step.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: every section adds non-obvious, LCD-specific facts (the key list with semantics, system-managed keys to avoid, live-apply behavior via the file watcher, ~100ms timing) with zero padding and no explanation of JSON/Node basics Claude already knows. Matches the anchor-5 'every token earns its place' example.

5 / 5

Actionability

Fully executable, copy-paste-ready code: a merge-style Node script that preserves unknown keys and writes pretty JSON with a trailing newline (the placeholder edit is explicitly flagged with "Replace this with the user's requested setting"), plus an executable one-line validation command. Anchor 5's 'copy-paste ready ... covers the common cases' is satisfied.

5 / 5

Workflow Clarity

The workflow is a clear sequence (read existing JSON, preserve unknown keys, merge only requested updates, write, avoid unrelated files) with an explicit, executable validation step — better than anchor 4's vague 'verify output is valid', but it lacks anchor 5's error-recovery feedback loop (no guidance on what to do if validation fails, e.g., restore from the read-back copy). Sits between the 4 and 5 anchors; no destructive/batch-operation cap applies since the merge preserves existing state and validation is present.

4.5 / 5

Progressive Disclosure

A single-file skill with no bundle files (references/, scripts/, assets/ are absent) and no content that belongs in a separate file — the key reference table, one script, and one validation command are all appropriately inlined. Sections are clearly organized (Preferences file, Workflow, Safe edit command, Validation), matching the simple-skill guidance that well-organized sections suffice when no external references are needed.

5 / 5

Total

19.5

/

20

Passed

Description

95%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: it names the exact file, the concrete operation, an explicit use-only-when trigger clause with real user phrasings, and a clearly bounded niche. The only weakness is that the action vocabulary is limited to reading/updating rather than a richer set of distinct capabilities.

DimensionReasoningScore

Specificity

Concrete actions ("safely reading and updating ~/.letta/desktop_preferences.json") plus specific enumerated settings ("theme, default working directory, remote access preference, or remote environment name") give minor coverage gaps at most. It stops short of the anchor-5 bar of multiple distinct concrete actions (roughly two verbs here: reading and updating), but clearly exceeds anchor 4's 'minor gaps' wording being the ceiling.

4 / 5

Completeness

Explicitly answers both what ("Edits Letta Code Desktop (LCD) preferences by safely reading and updating ~/.letta/desktop_preferences.json") and when ("Use only when the user asks to change current Desktop/LCD settings such as theme, default working directory...") with concrete trigger phrases. Matches the anchor-5 good example's structure exactly; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user phrasings ("change ... theme", "default working directory", "remote access preference"), the synonym pair "Desktop/LCD", and the concrete file name "desktop_preferences.json" give comprehensive natural-term coverage including the file extension. Anchor 4 ('a few natural terms missing') doesn't apply — the common ways a user would ask for these settings are covered.

5 / 5

Distinctiveness Conflict Risk

A clear niche (one product's preferences file) with distinct triggers and explicit scoping ("via the preferences JSON"), making wrong-skill triggering unlikely. The body further disambiguates against product-code/UI tasks, but even the description alone is minimally conflatable with other skills.

5 / 5

Total

19

/

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.