src/skills/builtin/finding-agents/SKILL.md
Find other agents on the same server. Use when the user asks about other agents, wants to migrate memory from another agent, or needs to find an agent by name or tags.
npx skillsauth add letta-ai/letta-code finding-agentsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill helps you find other agents on the same Letta server.
letta agents list [options]
| Option | Description |
|--------|-------------|
| --name <name> | Exact name match |
| --query <text> | Fuzzy search by name |
| --tags <tag1,tag2> | Filter by tags (comma-separated) |
| --match-all-tags | Require ALL tags (default: ANY) |
| --include-blocks | Include agent.blocks in response |
| --limit <n> | Max results (default: 20) |
Agents created by Letta Code are tagged with origin:letta-code. To find only Letta Code agents:
letta agents list --tags "origin:letta-code"
This is useful when the user is looking for agents they've worked with in Letta Code CLI sessions.
If the user has agents created outside Letta Code (via ADE, SDK, etc.), search without the tag filter:
letta agents list
List all agents (up to 20):
letta agents list
Find agent by exact name:
letta agents list --name "ProjectX-v1"
Search agents by name (fuzzy):
letta agents list --query "project"
Find only Letta Code agents:
letta agents list --tags "origin:letta-code"
Find agents with multiple tags:
letta agents list --tags "frontend,production" --match-all-tags
Include memory blocks in results:
letta agents list --query "project" --include-blocks
Returns the raw API response with full agent details. Key fields:
id - Agent ID (e.g., agent-abc123)name - Agent namedescription - Agent descriptiontags - Agent tagsblocks - Memory blocks (if --include-blocks used)--all-agents to get agent_id values, then use this skill to get full agent details.If you need to find which agent worked on a specific topic:
searching-messages and finding-agentsletta messages search --query "topic" --all-agents --limit 10
agent_id values from matching messagesletta agents list --query "partial-name"
Or use the agent_id directly in the Letta APItools
Schedules reminders and recurring tasks via the letta cron CLI. Use when the user asks to be reminded of something, wants periodic messages, or needs to manage scheduled tasks.
tools
# Skill Execute a skill within the main conversation When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge. When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it. How to invoke: - Use this tool with the skill name and optional arguments - Examples: - `skill: "pdf"` - invoke the pdf skill - `skill: "commit", a
documentation
Guide for working in parallel with other agents. Use when another agent is already working in the same directory, or when you need to work on multiple features simultaneously. Covers git worktrees as the recommended approach.
testing
Manage git-backed memory repos. Load this skill when working with git-backed agent memory, setting up remote memory repos, resolving sync conflicts, or managing memory via git workflows.