CtrlK
BlogDocsLog inGet started
Tessl Logo

creating-mods

Creates and edits trusted local Letta Code mods, including tools, slash commands, local-only model providers, lifecycle/turn events, scoped conversation helpers, panels, and capability-gated behavior. Use when asked to make a mod, add an agent-callable tool, add a slash command, add a local provider/model adapter, transform turns, react to app events, or add lightweight mod UI outside the dedicated /statusline flow.

75

Quality

92%

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

85%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 skill body: decision tables for capability choice, an explicit workflow with validation and recovery, a pre-flight checklist, and clean one-level-deep disclosure into nine real reference files. Weaknesses are limited to minor duplication of two rules and placeholder comments in the code skeleton.

Suggestions

Deduplicate 'Do not create project mods' (stated in both the location section and Rules) and compress the repeated multi-capability guard explanation in the checklist to a short reference to the full rule.

Make the core mod shape example more copy-paste ready by replacing the `/* ... */` placeholders with a minimal real registration (e.g. a one-line tool or command with name and description fields).

Merge the workflow's step-4 recipe list and the trailing References table into a single 'Load when' table to remove the duplicated navigation guidance.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely domain-specific (capability tables, file locations, scoped API rules Claude cannot know elsewhere), with no padding explaining general concepts. Minor trimming is possible: 'Do not create project mods' appears verbatim at both the location section and the Rules section, and the multi-capability guard sentence is stated in full twice (body text and checklist). That puts it at anchor 4 ('efficient; minor instances that could be trimmed') rather than 5.

4 / 5

Actionability

Concrete, executable guidance dominates: a full `activate(letta)` skeleton with disposer pattern, the capabilities list, exact paths (`~/.letta/mods/foo.ts`), the diagnostics call with severity semantics, and recovery commands (`letta --no-mods`, `LETTA_DISABLE_MODS=1 letta`, `letta mods package ...`). It stops short of anchor 5 because the core code example uses `/* ... */` placeholders in the register calls and detailed recipes are delegated to references, so it is 'mostly executable with minor gaps' rather than copy-paste ready.

4 / 5

Workflow Clarity

The 9-step Workflow has a clear sequence, an explicit validation step ('Do a basic review: valid names, descriptions present, schemas are object schemas, optional capabilities guarded, scoped APIs used, cleanup returned'), a full pre-flight checklist for complex mods, and an error-recovery path ('If a mod breaks startup or command handling, recover with `letta --no-mods`'). Validation plus feedback loop plus checklist matches the top anchor exactly.

5 / 5

Progressive Disclosure

The body is a genuine overview and every capability's detail lives one level deep in real, verified files (references/tools.md, commands.md, providers.md, events.md, permissions.md, ui.md, plan-mode.md, analysis-mode.md, architecture.md — all present in the bundle). Each is loaded conditionally via a 'Load when' decision rule stated twice (workflow step 4 and the References table), making navigation easy. Only a mild nit — the load-when mapping is duplicated — keeps this from being anything less than the top anchor.

5 / 5

Total

18

/

20

Passed

Description

100%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 model description: third person, specific capability enumeration, explicit multi-trigger 'Use when' clause, and explicit boundary demarcation against the statusline skill. It scores at the top anchor on all four dimensions with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description enumerates the full capability surface concretely — "tools, slash commands, local-only model providers, lifecycle/turn events, scoped conversation helpers, panels, and capability-gated behavior" — which is comprehensive coverage of multiple specific actions, matching the top anchor. It exceeds anchor 4 ('lists several specific actions; minor gaps') because no capability listed in the body's decision table is missing from the description.

5 / 5

Completeness

It explicitly answers both questions: what ("Creates and edits trusted local Letta Code mods, including...") and when ("Use when asked to make a mod, add an agent-callable tool...") with concrete trigger phrases. This matches the anchor-5 example structure exactly; anchor 4 ('when' could be more explicit) does not apply since the when-clause lists seven distinct explicit triggers.

5 / 5

Trigger Term Quality

The 'Use when' clause gives natural paraphrased triggers users would actually say: "make a mod", "add an agent-callable tool", "add a slash command", "add a local provider/model adapter", "transform turns", "react to app events", "add lightweight mod UI". Coverage is comprehensive with synonyms (e.g. 'provider/model adapter'); it falls at anchor 5 rather than 4 because no common natural phrasing for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche ("trusted local Letta Code mods") and even disambiguates from the nearest neighboring skill — "outside the dedicated /statusline flow" — which the body confirms is a separate skill. Conflict risk is minimal; it is far more distinct than the anchor-4 example ('mostly distinct; minor overlap risk').

5 / 5

Total

20

/

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.