教你的 Agent 试穿新衣服
一个遵循 agentskills.io 开放标准的 Markdown 文件。Agent 读完就知道什么时候该试穿、怎么拿 key、该调哪个接口。
--- name: tryonanytime description: Virtual try-on as a tool — put any garment onto any person photo and get the result image back. Use this whenever a user asks to see how clothing looks on someone, preview an outfit, or try a garment from any store, via the TryOnAnytime MCP server (preferred) or its REST API. --- # TryOnAnytime — Virtual Try-On for Agents ## When to use ## When NOT to use ## Setup ## Preferred: MCP server ## Fallback: REST API v1 ## Rules ## Errors …
它是怎么工作的
没有 SDK，没有插件体系，也不用改配置。Skill 就是一个文件，Agent 运行时自己就会找到它。
- 01
下载 skill.md
把我们的 SKILL.md 存进 Agent 运行时的 skills 目录——pi、Claude Code 或任何兼容 agentskills 的客户端，一条 curl 搞定。
- 02
Agent 自动发现
运行时会自动扫描 skills 目录。frontmatter 里的描述会告诉 Agent：什么时候该用到虚拟试穿。
- 03
直接开口就行
在任意对话里说「帮我把这件外套试穿到我的照片上」。Agent 会照 skill 的指引：拿 key、调 MCP、把结果给你看。
一行命令装好
选你的运行时。所有方式装的都是同一个文件——放进 Agent 会扫描的 skills 目录就行。
mkdir -p ~/.pi/agent/skills/tryonanytime && curl -fsSL https://tryonanytime.com/skill.md -o ~/.pi/agent/skills/tryonanytime/SKILL.md
运行时不支持 skills？直接把 skill.md 的链接粘贴进任意对话，Agent 读完之后整个会话都会照做。
skill 里写了什么
一份简短的说明书，Agent 读一遍，之后每次你说要试穿它都会照做。
## When to use
遇到「帮我试穿这件」这类请求时才触发，其他时候保持安静。
## Setup
一步步引导 Agent 到 TryOnAnytime 控制台拿到 sk_ 开头的 API key。
## Preferred: MCP server
优先接 MCP 端点，三个工具：virtual_tryon、get_tryon_result、get_credit_balance。
## Fallback: REST API v1
运行时没有 MCP 客户端时，退回普通的 REST v1 接口。
## Rules
图片最大 10MB（jpeg/png/webp）、每个 key 每 5 秒一次请求、每次试穿扣 10 积分。
## Errors
教 Agent 看懂 401/402/429 并报错恢复，而不是无脑重试刷接口。
Skill、MCP、REST 是什么关系
同一台试穿引擎的三层。skill 会告诉 Agent 什么时候该用哪一层。
SKILL.md —— 说明书
告诉 Agent 什么时候该试穿、怎么拿 key、优先接哪个接口。
MCP —— 接口
skill 首选的接入方式：一条 HTTP 连接，三个工具。
REST —— 兜底
给没有 MCP 的运行时准备的 v1 接口——同一引擎、同一把 key、同样的价格。