用途:当用户已提供技能 URL、slug 或明确的导入意图时,把指定技能安装到当前 Multica 工作区的技能数据库中。导入只支持工作区导入端点,要么用托管 URL,要么上传本地归档(.skill / .zip)。
主要能力与用法:用 CLI 执行 multica skill import --url <url> --output json 导入托管来源,或用 multica skill import --file <path-to.skill> --output json 导入本地归档;两者互斥,必须且只能选一个。URL 导入走 POST /api/skills/import,JSON 体为 { "url": "<url>", "on_conflict": "fail" };文件导入是同一路由下的 multipart/form-data。支持 hosts 包括 clawhub.ai、skills.sh、github.com(含 owner/repo、/tree/{ref}/…、/blob/{ref}/…/SKILL.md 及裸 ClawHub slug),其它 host 返回 400。
冲突策略:默认 --on-conflict fail;可选 overwrite(仅原作者可覆盖,保留 ID 与绑定)、rename(新建 -2/-3 副本)、skip。导入返回结构化结果信封,含 status、skill、existing_skill 等字段,以返回值为准。
绑定与更新:导入后用 multica agent skills add <agent-id> --skill-ids <skill-id> --output json 追加绑定,再用 list 校验;注意 add 为追加,set 为全量替换。已导入技能更新用 multica skill refresh <skill-id> --output json,权限为创建者或工作区管理员。
限制:不得用 npx skills add,它不会写入 Multica 工作区数据库。SKILL.md 为保留文件名,支持文件若同名会被静默丢弃。读取默认仅元数据,需正文用 --with-content。