Skip to content
Sign up
Features

Skills

Create and use reusable skills to extend your agent's capabilities

Letta Agent implements the open Agent Skills standard. Skills are portable across Letta Agent, Codex, Claude Code, Hermes Agent, OpenClaw, and other compatible agents.

Skills are directories containing instructions and resources that your agent can load when relevant. Think of them as reference guides your agent consults for specialized tasks — API patterns, testing workflows, deployment procedures.

In most agents, skills are “device-bound” - they are stored on the machine the agent is running on, so if your agent moves machines, it loses the skills. In Letta Agent, your agents can write skills into their own memory systems, so that skills persist with the agent as part of its identity.

The easiest way to install a skill is to simply ask your agent to install it. For example, to install the frontend design skill from Anthropic’s example skills repo (which teaches your agent how to build pretty websites), you can simply ask Letta Code:

> Can you install the following skill? https://github.com/anthropics/claude-code/tree/main/plugins/frontend-design/skills/frontend-design

You can also install skills from the Letta desktop app:

  1. Open the Skills page.
  2. Click Add skill.
  3. Choose Import from GitHub.
  4. Paste a GitHub URL that points to a skill directory containing SKILL.md.
  5. Click Import.

The desktop app validates the URL, clones the repository, verifies the skill, and installs it globally on your machine. You can then attach that skill to an agent from the Skills page.

To install directly into an agent’s MemFS from the CLI, use:

Terminal window
letta install <skill-source> --agent <agent-id>
letta skills list --agent <agent-id>
letta skills delete <skill-name> --agent <agent-id>

<skill-source> can be a GitHub skill directory, a Hermes-style official/... skill, or a ClawHub clawhub/... or clawhub:<slug> skill.

You can also manually install skills by copying the folder to one of the supported skills folders that Letta Code reads from (see below).

Start by browsing (or ask your agent to browse) the Letta and Anthropic skills repos. A few recommend skills include:

Letta Code automatically decides when to load a relevant skill, but you can also invoke one explicitly from the prompt with slash syntax:

Terminal window
/<skill-name> [optional instructions]

For example:

Terminal window
/acquiring-skills find and install a skill for browser testing

Direct invocation is useful when you already know which skill should guide the work. Letta Code loads the skill’s instructions into the conversation, then continues with the rest of your request.

Use /skills to browse available skills by source before invoking one by name.

You may want to create new skills to capture important reusable behaviors. For example, while working on your project, there may be certain sequences of actions taken by developers (e.g. a database migration) that is best represented to the agent as a skill to be used by many agents, rather than a memory.

Letta agents have a built-in “skill creator” skill, so you can simply prompt your agent to create a new skill:

> Can we turn the database migration we just did into a project-scoped skill?

For creating skills by hand, refer to the official Agent Skills documentation.

Letta Code also ships a built-in letta-help skill. The Tutor personality uses it for guided onboarding, and you can invoke it directly when you want a walkthrough of memory, delegation, tools, skills, search, subagents, or schedules:

Terminal window
/letta-help help me get started

Each skill is a directory containing a SKILL.md file. Letta Code automatically registers skills from multiple locations:

LocationScopeDescription
.agents/skills/Project-scoped (preferred)Primary project-local location for interactive client-side skills
.skills/Project-scoped (legacy)Older project-local location, still supported as a fallback
~/.letta/agents/{id}/memory/skills/Agent-scoped MemFSPersistent skills specific to one Letta Agent, stored inside that agent’s git-backed memory filesystem
~/.letta/skills/GlobalSkills shared across all Letta agents running on this machine
(bundled with Letta Code)Built-inSkills that ship with Letta Code (always available to any Letta Agent)

For MemFS-enabled agents, the agent-scoped skills directory is also available as $MEMORY_DIR/skills in shell tools. For example, if MEMORY_DIR=/Users/me/.letta/agents/agent-123/memory, then that agent’s persistent custom skills live under /Users/me/.letta/agents/agent-123/memory/skills.

When you start Letta Code, it scans all skill directories and makes available skills visible to the agent via system reminder messages in the conversation. Skills with conflicting (same) names are resolved by priority - project skills override agent-scoped MemFS skills, which override global skills, which override bundled skills.