OpenParable
Skip to content
← Back to skills

Yao Agent

Agent Building
yao-agent

Yao Agent is an Agent Skill for agent building published in the YaoApp/yao repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/YaoApp/yao/blob/HEAD/tools/skills/yao-agent/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/yao-agent, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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"}'
ParameterTypeRequiredDescription
namespacestringnoFilter 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"}'
ParameterTypeRequiredDescription
idstringyesAgent 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"}'
ParameterTypeRequiredDescription
idstringyesAgent 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"}'
ParameterTypeRequiredDescription
idstringyesAgent ID in dot notation. Must use smith namespace.
messagestringnoOptional 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