CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

initializing-memory

Comprehensive guide for initializing or reorganizing agent memory. Load this skill when running /init, when the user asks you to set up your memory, or when you need guidance on creating effective memory files.

65

Quality

82%

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.

A strong, densely-written orchestration skill: every step is executable with real commands, validation and feedback loops are explicit at each phase, and the bundle scripts it depends on exist and are correctly referenced. The only structural gap is that all reference material is inline in SKILL.md rather than partially deferred to reference files.

DimensionReasoningScore

Conciseness

Dense, imperative prose with essentially no explanation of concepts Claude already knows — every section carries skill-specific constraints (harness validation rules, budget math, provenance gates). Minor wordy passages (the ownership paragraph, several long Step 8 sentences) could be trimmed, which matches anchor 4 rather than 5; it is above anchor 3 because there is no padded or instructional filler.

4 / 5

Actionability

Copy-paste-ready commands throughout: 'git shortlog -sn --all | head -5', 'letta trajectories export --out /tmp/letta-trajectories', the prepare-history and history-coverage script invocations (both files exist in scripts/), the frontmatter-violation find pipeline, and the full commit block. The workflow JSON-schema code is complete and executable, and the one flexible piece (the workflow script shape) is explicitly justified as design freedom.

5 / 5

Workflow Clarity

Ten numbered steps with explicit validation checkpoints and feedback loops: Step 8's coverage check writes retry.json and prescribes a follow-up run plus re-check; Step 9 is a verification checklist; Step 10 requires 'git status' to come back clean before reporting. Error-recovery paths (model fallback, Workflow unavailable, incomplete coverage) are spelled out, matching anchor 5.

5 / 5

Progressive Disclosure

The body is cleanly sectioned (Principles, Harness Constraints, Structure, Initialization Flow, Critical) and both bundle scripts are real, correctly referenced files at <SKILL_DIR>/scripts/. However, all guidance lives inline in a ~205-line SKILL.md with no one-level-deep reference files — the example structures and the workflow-schema reference could be deferred — which fits anchor 4 rather than 5, and is above anchor 3 because what is inline is well-signaled and appropriately placed for the core flow.

4 / 5

Total

18

/

20

Passed

Description

70%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 serviceable description with an explicit, well-phrased trigger clause and third-person voice, but the capability statement is generic — 'Comprehensive guide' plus two domain-level actions — so it under-sells the skill's concrete operations. Distinct from other skills and low conflict risk.

Suggestions

Replace 'Comprehensive guide for' with the concrete operations the skill performs, e.g. 'Structure agent memory directories with per-directory MEMORY.md indexes, analyze approved session history, research the codebase, and verify and commit the result.'

Add natural trigger variations such as 'organize my memory', 'reorganize memory', or 'initialize memory' to the when-clause.

State the outcome of running the skill (a committed, validated memory tree) so the 'what' answers what the user gets, not just the domain.

DimensionReasoningScore

Specificity

"initializing or reorganizing agent memory" and "creating effective memory files" name the domain with 1-2 actions, but "Comprehensive guide" is padding and no concrete operations (structuring indexes, analyzing session history, research, verification, commit) appear. Fits anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); not 4 because the action list is neither several nor specific, not 2 because the domain and actions are named rather than minimal.

3 / 5

Completeness

The 'when' is explicit with concrete trigger phrases ("when running /init, when the user asks you to set up your memory..."), and the 'what' is present ("initializing or reorganizing agent memory"). The 'what' is generic ('Comprehensive guide for...') rather than enumerating what the skill does, so it does not reach anchor 5; it is above anchor 3 because the when-clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Triggers "when running /init", "set up your memory", and "creating effective memory files" are natural phrases a user would say. Missing common variations like "organize my memory" or "initialize memory" as explicit triggers, so it sits at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

"agent memory" initialization/reorganization is a clear niche and "/init" is a distinct trigger unlikely to fire for other skills. Minor overlap risk with generic memory-management or note-taking skills keeps it at anchor 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

letta-ai/letta-code

Path

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