# agent-management

This skill controls AI agents through the AI Maestro CLI, from creation and status checks to hibernation and plugin changes. Use it when several agents need lifecycle commands.

- skill · `type=skill` · Claude Code · 690 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-maestro/agent-management
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/agent-management

## What it does

The skill connects Claude Code to the AI Maestro command line and covers agent lifecycle tasks. It can create an agent with a directory, show agents and their details, change a task or tags, rename an agent, remove it, hibernate it, wake it, or restart it.

The same command set handles plugins: install or remove one for an agent, list installed plugins, and add a marketplace source. It can also export an agent configuration or import one from a file. Agent states include `online`, `offline`, and `hibernated`. AI Maestro must be running locally, and `tmux 3.0+` is required, or these commands will not run.

Set up the CLI by cloning `ai-maestro-plugins`, entering that directory, and running `./install-agent-cli.sh`. The skill then uses commands such as `aimaestro-agent.sh create <name> --dir <path>` and `aimaestro-agent.sh hibernate <agent>` to act on agents.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill ai-maestro/agent-management
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill agent-management -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/agent-management/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-management/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/agent-management/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/agent-management/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates agent-management
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-management/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-maestro/agent-management
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-management/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-maestro/agent-management

## When to use it
- create an agent with a project directory
- install a plugin for one agent
- pause agents while saving their state
- export configuration before risky changes
- restore an agent from a file

## Example prompts
- Create `backend-api` in `~/projects/backend` and assign it a TypeScript REST API task.
- List every agent with its current state using `aimaestro-agent.sh list`.
- Hibernate `frontend-ui`, then wake it and attach to its session.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md