Skills
Skills 是可注册到 AIO Sandbox 的自包含指令和工具包，可被 Agent 工作流发现和使用。
Skill 结构
一个 Skill 目录通常包含：
my-skill/
SKILL.md
scripts/
templates/
requirements.txt
package.json
SKILL.md 是入口文件，包含 frontmatter 元数据和 Markdown 指令。
---
name: report-writer
description: Create structured reports from source material.
---
# Report Writer
Use this skill when a task requires a structured report.
注册 Skill
注册沙盒内已经存在的 Skill 目录：
curl -X POST "http://localhost:8080/v1/skills/register" \
-F "path=/home/gem/skills/report-writer"
上传 zip 并解压到目标目录：
curl -X POST "http://localhost:8080/v1/skills/register" \
-F "file=@report-writer.zip" \
-F "path=/home/gem/skills" \
-F "name=report-writer"
查询 Skills
curl "http://localhost:8080/v1/skills/metadatas"
读取 Skill 内容
curl "http://localhost:8080/v1/skills/report-writer/content"
删除 Skill
curl -X DELETE "http://localhost:8080/v1/skills/report-writer"
最佳实践
description 保持简短，并说明触发场景。- 大段代码放在脚本中，不要塞进 Markdown 指令。
- 依赖声明保持明确、可复现。
- 不要把密钥写入 Skill 文件。
