Agent Skills › YaoApp/yao › yao-workspace

yao-workspace

GitHub

提供远程工作区文件I/O专家能力，支持列出、获取工作区详情及浏览、读写文件。用于跨节点文件操作，区别于本地沙箱文件系统工具。

tools/skills/yao-workspace/SKILL.md YaoApp/yao

触发场景

需要列出或查询远程工作区信息需要在远程工作区内读取或写入文件需要浏览远程工作区的目录结构

安装

npx skills add YaoApp/yao --skill yao-workspace -g -y

更多选项

非标准路径

npx skills add https://github.com/YaoApp/yao/tree/main/tools/skills/yao-workspace -g -y

不安装直接使用

npx skills use YaoApp/yao@yao-workspace

指定 Agent (Claude Code)

npx skills add YaoApp/yao --skill yao-workspace -a claude-code -g -y

安装 repo 全部 skill

npx skills add YaoApp/yao --all -g -y

预览 repo 内 skill

npx skills add YaoApp/yao --list

SKILL.md

Frontmatter

{
    "name": "yao-workspace",
    "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."
}

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.

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.

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.

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.

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

Write content to a file in workspace. For binary files, use base64 encoding.

tai tool workspace_file_write '{"id": "ws-abc123", "path": "output.txt", "content": "Hello World"}'
tai tool workspace_file_write '{"id": "ws-abc123", "path": "data.bin", "content": "base64data...", "encoding": "base64"}'

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

Typical Workflow

workspace_list — discover available workspaces
workspace_get — get full details (node, labels)
workspace_file_list — browse directory structure
workspace_file_read — read specific files
workspace_file_write — write output files

Guidelines

Use workspace_list for discovery, workspace_get for details (list returns summaries only)
For large files (>1MB), prefer local filesystem operations if the workspace is mounted in the sandbox
Use encoding: "base64" for binary files (images, archives, etc.)
File paths are relative to the workspace root — do not use absolute paths
The current sandbox workspace ID is available via $CTX_WORKSPACE_ID
All output is JSON