finding-agents
Quickly locate and filter agents running on your Letta server by name, tags, or IDs.
Install
mkdir -p .claude/skills/finding-agents && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4249" && unzip -o skill.zip -d .claude/skills/finding-agents && rm skill.zipInstalls to .claude/skills/finding-agents
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →List active agents on a server
- →Search agents by fuzzy name matching
- →Filter agent results by metadata tags
- →Retrieve agent memory block details
- →Identify agent IDs for migration workflows
How it works
It translates natural language requests into `letta agents list` CLI commands with specific flag parameters like `--query` or `--tags`.
Inputs & outputs
When to use finding-agents
- →Locate a specific agent by name to inspect its ID
- →Find all agents with a specific tag for batch operations
- →Get a list of existing agents to plan a memory migration
- →Search for agents by partial name match
About this skill
Finding Agents
This skill helps you find other agents on the same Letta server.
When to Use This Skill
- User asks about other agents they have
- User wants to find a specific agent by name
- User wants to list agents with certain tags
- You need to find an agent ID for memory migration
- You found an agent_id via message search and need details about that agent
CLI Usage
letta agents list [options]
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) |
Common Patterns
Finding Letta Code Agents
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.
Finding All Agents
If the user has agents created outside Letta Code (via ADE, SDK, etc.), search without the tag filter:
letta agents list
Examples
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
Output
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-blocksused)
Related Skills
- migrating-memory - Once you find an agent, use this skill to copy/share memory blocks
- searching-messages - Search messages across all agents to find which agent discussed a topic. Use
--all-agentsto getagent_idvalues, then use this skill to get full agent details.
Finding Agents by Topic
If you need to find which agent worked on a specific topic:
- Load both skills:
searching-messagesandfinding-agents - Search messages across all agents:
letta messages search --query "topic" --all-agents --limit 10 - Note the
agent_idvalues from matching messages - Get agent details:
Or use the agent_id directly in the Letta APIletta agents list --query "partial-name"
When not to use it
- →When the agent is external to the Letta server
- →When the user needs to modify agent memory directly (use memory tools)
Prerequisites
Limitations
- →Limited to the scope of the current Letta server
- →Default search limit is 20, requiring pagination or adjustments for large registries
- →Requires specific tag formatting for accurate filtering
How it compares
It provides a specific interface for organizational tasks like migration planning, rather than just interacting with a single active agent.
Compared to similar skills
finding-agents side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| finding-agents (this skill) | 1 | 6mo | Review | Beginner |
| deep-research | 35 | 9mo | Review | Advanced |
| scientific-brainstorming | 37 | 7mo | No flags | Intermediate |
| gpt-researcher | 14 | 6mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by letta-ai
View all by letta-ai →You might also like
deep-research
davidorex
Multi-agent parallel investigation for complex VCV Rack problems
scientific-brainstorming
davila7
Research ideation partner. Generate hypotheses, explore interdisciplinary connections, challenge assumptions, develop methodologies, identify research gaps, for creative scientific problem-solving.
gpt-researcher
assafelovic
GPT Researcher is an autonomous deep research agent that conducts web and local research, producing detailed reports with citations. Use this skill when helping developers understand, extend, debug, or integrate with GPT Researcher - including adding features, understanding the architecture, working with the API, customizing research workflows, adding new retrievers, integrating MCP data sources, or troubleshooting research pipelines.
search-skill
GBSOSS
Search and recommend Claude Code skills from trusted marketplaces
agent-council
team-attention
Collect and synthesize opinions from multiple AI agents. Use when users say "summon the council", "ask other AIs", or want multiple AI perspectives on a question.
agent-scout-explorer
ruvnet
Agent skill for scout-explorer - invoke with $agent-scout-explorer