# Yao Agent Management

Lists, downloads and deploys Yao agents and queries the LLM connector matrix.

- Repository: https://github.com/YaoApp/yao (8244 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add YaoApp/yao --skill yao-agent -g -a claude-code -y`
Codex: `npx skills add YaoApp/yao --skill yao-agent -g -a codex -y`
Cursor: `npx skills add YaoApp/yao --skill yao-agent -g -a cursor -y`
Gemini CLI: `npx skills add YaoApp/yao --skill yao-agent -g -a gemini-cli -y`

## Description

Agent management expert. ALWAYS invoke this skill when you need to list available agents, download or reference agent source code, deploy agent code to the host, or query the LLM connector matrix. Do not guess agent structures, use this skill first.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent Tools

Five tools for managing agents on the host, called via bash.

## agent_list

List available agents. Returns ID, name, description, and capabilities for each agent.

```bash
tai tool agent_list '{}'
tai tool agent_list '{"namespace": "smith"}'
```

| Parameter   | Type   | Required | Description                                              |
|-------------|--------|----------|----------------------------------------------------------|
| `namespace` | string | no       | Filter by namespace (e.g. `yao`, `smith`). Omit for all. |

## agent_download

Download a **smith-namespace** agent into the development directory for editing. **Restricted to `smith` namespace only**, for other agents, use `agent_reference`.

```bash
tai tool agent_download '{"id": "smith.weather"}'
```

| Parameter | Type   | Required | Description                                              |
|-----------|--------|----------|----------------------------------------------------------|
| `id`      | string | yes      | Agent ID in dot notation. Must be `smith.*`.             |

Downloaded code lands in `agent-smith-dev/assistants/smith/<name>/`.

## agent_reference

Download agent source code from the host into `.references/` for **read-only study**. Any agent across all namespaces can be referenced.

```bash
tai tool agent_reference '{"id": "yao.slides"}'
tai tool agent_reference '{"id": "yao.keeper"}'
```

| Parameter | Type   | Required | Description                                        |
|-----------|--------|----------|----------------------------------------------------|
| `id`      | string | yes      | Agent ID in dot notation (e.g. `yao.slides`)       |

Referenced code lands in `agent-smith-dev/.references/<namespace>/<name>/`.

## agent_deploy

Deploy agent source code from the sandbox development directory to the host. **Restricted to the `smith` namespace only**, attempts to deploy to other namespaces will be rejected.

The rest: https://github.com/YaoApp/yao/blob/HEAD/tools/skills/yao-agent/SKILL.md