Delegate focused coding, research, review, or verification work to a bounded DevSpace subagent. Use when a task benefits from separate context, a specialist perspective, or a follow-up with the same worker.
Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
What it does
Delegate focused coding, research, review, or verification work to a bounded DevSpace subagent
When to use it
a task benefits from separate context, a specialist perspective, or a follow-up with the same worker
How agents load it
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: DevSpace subagents; Choose a target; Start work; Wait or inspect; Continue related work; Good uses.
File analysis
File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.
DevSpace subagentsChoose a targetStart workWait or inspectContinue related workGood uses
Delegate focused coding, research, review, or verification work to a bounded DevSpace subagent. Use when a task benefits from separate context, a specialist perspective, or a follow-up with the same worker.
DiscoverThe client exposes names and descriptions to the agent.
ActivateYour request or the task context selects the skill and loads its instructions.
Load resourcesReferenced scripts, documentation and assets are used when needed.
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
Ask your Agent to install
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "subagents" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-1a5f8b7076798367-Subagents.html
Save it as .cursor/skills/subagents/SKILL.md or .claude/skills/subagents/SKILL.md and keep the frontmatter name and description exactly as-is.
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
---
name: subagents
description: Delegate focused coding, research, review, or verification work to a bounded DevSpace subagent. Use when a task benefits from separate context, a specialist perspective, or a follow-up with the same worker.
---
# DevSpace subagents
Subagents are optional. Use the normal workspace tools for routine work; delegate only when a separate worker materially helps through independent context, specialization, or follow-up.
Run the DevSpace CLI through the shell or process tool from the project the subagent should use. Agent commands print compact XML fragments by default. Read that output directly. Do not add `--json`.
## Choose a target
Discover usable targets instead of guessing names:
```bash
devspace agents targets
```
Each line is a `` or `description` fragment. Pass the profile or provider `name` as ``. Prefer a matching profile. Use a provider target when no profile fits or the task needs a specific provider. Keep the configured model and effort unless the task requires a supported override.
## Start work
Give the subagent a self-contained brief with the objective, relevant paths, constraints, context it cannot infer, and the expected result. The subagent receives this brief and its profile instructions, not the parent conversation.
```bash
devspace agents run ""
devspace agents run --model --effort ""
```
The command returns an `` receipt. Keep the DevSpace agent ID for inspection, waiting, or follow-up.
## Wait or inspect
Use `wait` when work must finish before you proceed. One call can wait for several agents:
```bash
devspace agents wait
devspace agents wait
devspace agents wait --timeout 60
```
Without `--timeout`, the command waits until every named agent's current work finishes. A timeout returns one fragment per unique agent in first-seen order; unfinished work has `status="running" wait="timeout"`. Completed output is the element text. Failures include `code` and `retryable` attributes. The command does not stream partial results.
Use `show` for an immediate snapshot. Do not poll it when `wait` can express the dependency.
```bash
devspace agents show
devspace agents ls
```
`ls` lists agents for the current project. Empty `targets` and `ls` results print nothing.
## Continue related work
Continue an agent when its existing provider context helps. Start another agent for unrelated work.
```bash
devspace agents continue ""
devspace agents wait
```
## Good uses
- Review a change for correctness, security, or missing tests.
- Investigate a bounded part of a codebase and report findings.
- Implement one isolated change with clear acceptance criteria.
- Run a focused verification pass after other work.