How do I install the Yao Agent skill?

Run npx skillmds@latest add gabrielmoreira/yao-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Yao Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Yao Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Yao Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Yao Agent?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Yao Agent by gabrielmoreira — Agent Skill

Name: Yao Agent
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

Yao Agent

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.

gabrielmoreira Updated Sep 21, 2026 17 repo stars

File contents

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.

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.

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.

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.

tai tool agent_deploy '{"id": "smith.weather"}'
tai tool agent_deploy '{"id": "smith.weather", "message": "add SUI page"}'

Parameter	Type	Required	Description
`id`	string	yes	Agent ID in dot notation. Must use `smith` namespace.
`message`	string	no	Optional deploy message for logging.

agent_connectors

Get the current user's LLM connector matrix. Returns metadata for each role (default, heavy, light, vision, etc.) without API keys. Use this to understand which models are available and their capabilities.

tai tool agent_connectors '{}'

No parameters required.

Guidelines

Use agent_list to discover agents before downloading or referencing
agent_download is for editing smith agents — code lands in agent-smith-dev/assistants/smith/<name>/
agent_reference is for studying any agent — code lands in agent-smith-dev/.references/<namespace>/<name>/
Deploy is restricted to the smith namespace for safety
Connector data never includes API keys, secrets, or tokens
All output is JSON

---name: yao-agentdescription: 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.---# Agent ToolsFive tools for managing agents on the host, called via bash.## agent_listList available agents. Returns ID, name, description, and capabilities for each agent.```bashtai 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_downloadDownload a **smith-namespace** agent into the development directory for editing. **Restricted to `smith` namespace only** — for other agents, use `agent_reference`.```bashtai 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_referenceDownload agent source code from the host into `.references/` for **read-only study**. Any agent across all namespaces can be referenced.```bashtai 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_deployDeploy 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.```bashtai tool agent_deploy '{"id": "smith.weather"}'tai tool agent_deploy '{"id": "smith.weather", "message": "add SUI page"}'```| Parameter | Type | Required | Description ||-----------|--------|----------|--------------------------------------------------------|| `id` | string | yes | Agent ID in dot notation. Must use `smith` namespace. || `message` | string | no | Optional deploy message for logging. |## agent_connectorsGet the current user's LLM connector matrix. Returns metadata for each role (default, heavy, light, vision, etc.) **without API keys**. Use this to understand which models are available and their capabilities.```bashtai tool agent_connectors '{}'```No parameters required.## Guidelines- Use `agent_list` to discover agents before downloading or referencing- `agent_download` is for editing smith agents — code lands in `agent-smith-dev/assistants/smith/<name>/`- `agent_reference` is for studying any agent — code lands in `agent-smith-dev/.references/<namespace>/<name>/`- Deploy is restricted to the `smith` namespace for safety- Connector data never includes API keys, secrets, or tokens- All output is JSON

Frequently asked questions