letta-development-guide SKILL.md skillA

letta-development-guide from letta-ai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add letta-ai/skills/letta-development-guide@git:20260121.078e325

Pins git:20260121.078e325 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
letta-ai/skills
Path
letta/agent-development/SKILL.md
Versions recorded
2
Latest version
git:20260121.078e325, committed Jan 21, 2026
First version recorded
Dec 19, 2025
Size
9,308 bytes
Repository stars
152
License
a license file GitHub does not identify

Comprehensive guide for developing Letta agents, including architecture selection, memory design, model selection, and tool configuration. Use when building or troubleshooting Letta agents.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Letta Development Guide

Comprehensive guide for designing and building effective Letta agents with appropriate architectures, memory configurations, model selection, and tool setups.

## When to Use This Skill

Use this skill when:
- Starting a new Letta agent project
- Choosing between agent architectures (letta_v1_agent vs memgpt_v2_agent)
- Designing memory block structure and architecture
- Selecting appropriate models for your use case
- Planning tool configurations
- Optimizing memory management and performance
- Implementing shared memory between agents
- Debugging memory-related issues

## Quick Start Guide

### Minimal Working Example

```python
from letta_client import Letta

client = Letta()
agent = client.agents.create(
    name="my-assistant",
    model="openai/gpt-4o",
    embedding="openai/text-embedding-3-small",
    memory_blocks=[
        {"label": "persona", "value": "You are a helpful assistant."},
        {"label": "human", "value": "The user's name and preferences."},
    ],
)

# Send a message
response = client.agents.messages.create(
    agent_id=agent.id,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.messages[-1].content)
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add letta-ai/skills/letta-development-guide@sha256:0e54c5537a3b51fc

The line at the top of this page pins the label git:20260121.078e325, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cguc65fkc5djvub4.svg)](https://markdownregistry.com/a/art_cguc65fkc5djvub4)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Dec 19, 2025 and Jan 21, 2026, about one every 34 days.

versioncommittedcommitsizeaudit
git:20260121.078e325 latest2026-01-21 078e325 9,308 BA view · diff
git:20251219.b3de7442025-12-19 b3de744 7,525 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9308 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

letta-ai/skills · 152 stars · license a license file GitHub does not identify · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cguc65fkc5djvub4
GET https://markdownregistry.com/api/v1/resolve?ref=letta-ai/skills/letta-development-guide
GET https://markdownregistry.com/api/v1/blob/0e54c5537a3b51fcb47e6df3a9e2b2aba6bdaa24e48677076811af6936ef1aca

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from letta-ai/skills

Letta Conversations API SKILL.md skill
letta-ai/skills · letta/conversations/SKILL.md · Guide for using the Letta Conversations API to manage isolated message threads on agents. Use when building multi-user…
git:20260109.6063a75 · audit A · 152 stars
creating-letta-code-channels SKILL.md skill
letta-ai/skills · letta/creating-letta-code-channels/SKILL.md · Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under…
git:20261001.24a73a6 · audit A · 152 stars
letta-fleet-management SKILL.md skill
letta-ai/skills · letta/fleet-management/SKILL.md · Manage Letta AI agent fleets declaratively with kubectl-style CLI. Use when creating, updating, or managing multiple…
git:20260221.84f73cd · audit A · 152 stars
importing-chatgpt-memory SKILL.md skill
letta-ai/skills · letta/importing-chatgpt-memory/SKILL.md · Clone ChatGPT saved memory into Letta, then optionally enrich it with broader conversation history. Designed for a…
git:20260408.2bc2414 · audit A · 152 stars
letta-configuration SKILL.md skill
letta-ai/skills · letta/letta-configuration/SKILL.md · Configure LLM models and providers for Letta agents and servers. Use when setting model handles, adjusting…
git:20260204.eba0c2a · audit A · 152 stars
letta-filesystem-to-memfs SKILL.md skill
letta-ai/skills · letta/letta-filesystem-to-memfs/SKILL.md · Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical…
git:20260513.aeb5473 · audit A · 152 stars
navigating-chatgpt-history SKILL.md skill
letta-ai/skills · letta/navigating-chatgpt-history/SKILL.md · Navigates archived ChatGPT or Claude-style conversation exports and a MemFS reference archive on demand. Use when…
git:20260521.b7217b9 · audit A · 152 stars
self-configuration SKILL.md skill
letta-ai/skills · letta/self-configuration/SKILL.md · Configures Letta agents' own runtime behavior, including model, context window, system prompt, reasoning, conversation…
git:20260618.9da3d97 · audit A · 152 stars
setting-profile-images SKILL.md skill
letta-ai/skills · letta/setting-profile-images/SKILL.md · Sets Letta Desktop and Letta Code agent profile images by writing profile.png into an agent MemFS repository. Use when…
git:20260615.0d50d92 · audit A · 152 stars
skill-development SKILL.md skill
letta-ai/skills · meta/skill-development/SKILL.md · Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or…
git:20260204.eba0c2a · audit A · 152 stars
1password SKILL.md skill
letta-ai/skills · tools/1password/SKILL.md · Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or…
git:20260422.af6a950 · audit A · 152 stars
ai-news SKILL.md skill
letta-ai/skills · tools/ai-news/SKILL.md · Fetch and summarize recent AI news from curated RSS feeds (Hugging Face, VentureBeat, The Verge, OpenAI, Anthropic…
git:20260316.2512e61 · audit A · 152 stars

Every file in letta-ai/skills

Browse by kind, by grade A, or by owner.