yao agent

DevOps Community

Skill notes

agentlist

List available agents. Returns ID, name, description, and capabilities for each agent. Parameter · Type · Required · Description namespace · string · no · Filter by namespace (e.g. yao, smith). Omit for all.

agentdownload

Download a smith-namespace agent into the development directory for editing. Restricted to smith namespace only — for other agents, use agent_reference. 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>/.

agentreference

Download agent source code from the host into .references/ for read-only study. Any agent across all namespaces can be referenced. 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>/.

agentdeploy

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. Parameter · Type · Required · Description id · string · yes · Agent ID in dot notation. Must use smith namespace. message · string · no · Optional deploy message for logging.

agentconnectors

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. No parameters required.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
DevOps
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@YaoApp · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# 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.

```bash
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.

```bash
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

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.