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.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Quality

Content

92%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-structured, actionable skill body with concrete code, a validated multi-step workflow, and clean one-level-deep progressive disclosure to real reference files. The only weakness is mild repetition of the capability-guarding guidance.

Suggestions

Consolidate the capability-guarding guidance into one canonical statement and reference it from the other sections to reduce repetition.

The core mod shape example uses /* ... */ placeholders; add one minimal fully-filled example for the most common case (a single tool) to raise copy-paste readiness.

Tighten the Rules list by merging near-duplicate items (e.g., the standard-API guidance and the execFile/spawn guidance) to shorten the body.

Dimension	Reasoning	Score
Conciseness	Dense and domain-specific, assuming Claude's competence, but the capability-guarding guidance is restated across Workflow, Core mod shape, Rules, and the Pre-flight checklist, which could be tightened.	4 / 5
Actionability	Provides copy-paste-ready activate() code, concrete capability flags, scoped API names (ctx.conversation.fork(), getHistory()), file paths, and recovery commands (letta --no-mods), covering the common cases.	5 / 5
Workflow Clarity	A 9-step Workflow with explicit validation (basic review plus a pre-flight checklist) and an error-recovery feedback loop (letta --no-mods / LETTA_DISABLE_MODS=1) matches the anchor for a clear sequence with checkpoints.	5 / 5
Progressive Disclosure	SKILL.md is a well-signaled overview with two one-level-deep reference navigation tables; all nine referenced files exist in references/.	5 / 5
	Total	19 / 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 strong, third-person description that states concrete capabilities and pairs them with a comprehensive, naturally-worded 'Use when' trigger clause. It carves out a clear niche and explicitly disambiguates from the /statusline skill.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions (tools, slash commands, local-only model providers, lifecycle/turn events, scoped conversation helpers, panels, capability-gated behavior) with comprehensive coverage, matching the 5 anchor.	5 / 5
Completeness	Explicitly answers both 'what' (creates and edits trusted local Letta Code mods, including...) and 'when' (Use when asked to make a mod...) with concrete trigger phrases, matching the 5 anchor.	5 / 5
Trigger Term Quality	The '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' clause uses natural phrases a user would actually say, with comprehensive coverage of synonyms.	5 / 5
Distinctiveness Conflict Risk	Clear niche (Letta Code mods) with distinct triggers and an explicit exclusion ('outside the dedicated /statusline flow'), giving minimal conflict risk with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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/creating-mods/SKILL.md
Commit: 7a4337e

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.