# Yao Workspace

Workspace file I/O expert.

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

## Install

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

## Description

Workspace file I/O expert. ALWAYS invoke this skill when you need to list workspaces, read or write files in a workspace on a remote node, or browse workspace directories. Use this for cross-node file operations, for local sandbox files, use standard filesystem tools instead.

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

# Workspace Tools

Five tools for managing workspaces and file I/O, called via bash.

## workspace_list

List workspaces with summary info. Use `workspace_get` for full details.

```bash
tai tool workspace_list '{}'
tai tool workspace_list '{"node": "tai-node-1"}'
```

| Parameter | Type   | Required | Description              |
|-----------|--------|----------|--------------------------|
| `node`    | string | no       | Filter by Tai node ID    |

## workspace_get

Get full workspace details: name, owner, node, labels, timestamps.

```bash
tai tool workspace_get '{"id": "ws-abc123"}'
```

| Parameter | Type   | Required | Description   |
|-----------|--------|----------|---------------|
| `id`      | string | yes      | Workspace ID  |

## workspace_file_list

List files and directories in a workspace path.

```bash
tai tool workspace_file_list '{"id": "ws-abc123"}'
tai tool workspace_file_list '{"id": "ws-abc123", "path": "src/components"}'
```

| Parameter | Type   | Required | Description                    |
|-----------|--------|----------|--------------------------------|
| `id`      | string | yes      | Workspace ID                   |
| `path`    | string | no       | Directory path (default ".")   |

## workspace_file_read

Read file content from workspace. Returns text (UTF-8) or base64 encoded.

```bash
tai tool workspace_file_read '{"id": "ws-abc123", "path": "README.md"}'
tai tool workspace_file_read '{"id": "ws-abc123", "path": "image.png", "encoding": "base64"}'
```

| Parameter  | Type   | Required | Description                              |
|------------|--------|----------|------------------------------------------|
| `id`       | string | yes      | Workspace ID                             |
| `path`     | string | yes      | File path relative to workspace root     |
| `encoding` | string | no       | "text" (default) or "base64"             |

## workspace_file_write

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