Practical overview
When it fits
Use it when working in Claude Code and a task benefits from a named development specialty or a choice among focused agent files.
Who it is for
- Claude Code users seeking role-specific assistance across software development.
- Developers who want to add selected specialist instruction files to Claude Code’s agents directory.
Documented uses
- Assign a development task to a relevant specialist, such as a frontend developer, Python specialist or backend architect.
- Get task-focused help with code review, debugging, QA, testing or security review.
- Seek guidance on infrastructure, data engineering, AI and machine-learning work, or technical documentation.
Requirements & limits
The repository is public and specifies an MIT license. Its README describes local installation in Claude Code’s `~/.claude/agents/` directory.
- The collection lists 33 roles, organized across development, infrastructure, quality and testing, data and AI, security, specialization and business.
- The README describes both automatic selection based on task context and explicit invocation.
- Adding agent files is separate from the README’s optional MCP server configuration; one server in the example requires an API key.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add selected subagent files to Claude Code
Place chosen agent files in the Claude Code agents directory so the tool can load them.
Before you start
- Claude Code
- The desired subagent Markdown files from the repository
- Access to the local
~/.claude/agents/directory
Steps
Create
~/.claude/agents/lst97to keep these files in a separate directory.Copy the selected agent files into that directory.
Start Claude Code; the README says it detects and loads agents placed in
~/.claude/agents/on startup.Ask Claude Code to list available subagents to check whether it recognizes them.
Expected outcome
Selected collection agents are placed in Claude Code’s agents directory for loading and recognition.
Guide limitations
- The README notes that using the collection’s global setup may conflict with another repository.
- The recognition prompt is a documented check, not a guarantee that every agent or task will work as intended.
Clone the collection into the Claude agents directory
Install the repository in the directory Claude Code uses to detect agents.
Before you start
- Claude Code
- Git
- Access to the local
~/.claudedirectory
Steps
Change to
~/.claude.Clone
https://github.com/lst97/claude-code-sub-agents.gitinto that directory.Start Claude Code so it can detect and load the agents.
Expected outcome
The repository is present under the Claude configuration directory for agent discovery.
Guide limitations
- The README warns that the global setup may conflict with another repository.
- The README also gives a pull command for an existing directory, but does not explain how to distinguish that repository from other contents.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- lst97/claude-code-sub-agents · Official homepage title · retained in its source language

