用途:让智能体用 curl 直接调用 Penpot 的 RPC API,完成设计文件与项目的创建、读取、重命名、删除、复制,以及列出项目、团队、项目内文件、读取账户/团队/项目元数据、验证令牌(get-profile)。不涉及画布内容编辑。
主要能力:Penpot API 为命令式 RPC,每个操作都是向 <base_url>/api/rpc/command/<command-name> 发送带 JSON 体的 POST,使用个人访问令牌认证。技能通过内置 OpenAPI 规范中的命令索引与 $ref 解析器查找命令、构造 curl 并解析 JSON。覆盖文件、项目、团队、个人资料等操作面。
使用方式:凭据由调用方注入,技能本身不提供或解析凭据。令牌仅以变量名形式出现,curl 从环境读取其值,认证头为 Authorization: Token $PENPOT_TOKEN(是 Token 而非 Bearer)。先扫描 assets/endpoint-index.md 找到命令,再运行 python3 scripts/endpoint.py <command> 解析请求体字段,然后构造并执行 curl。所有调用均为 POST,必须带 Accept: application/json,否则可能返回 transit 编码。
限制:不支持通过 update-file 编辑画布内容(需 sessionId 与修订号,属内部 transit 编码格式);不负责凭据配置;不面向编辑器绑定的 Penpot MCP。列表命令无分页;get-file 可能返回超大文档,建议用摘要类命令。规范仅声明请求体,错误以 {type, code, hint} 信封返回。字段名因命令而异(id 与 fileId 等),需解析而非猜测。