@yandy0725/mediagen-cli 0.3.0 → 0.3.1

package/README.md

@@ -254,11 +254,21 @@ download and 600 s per video download. For video that budget is the *whole* poll
 window, not one request: each create or poll gets 60 s, so a hung request cannot eat
 the budget, and the download has its own 600 s and is not counted against it.
 
-Working from an agent? `mediagen skill install --dir <skills dir>` puts
-`skills/mediagen/SKILL.md` where your agent already looks — e.g. `--dir ~/.claude/skills` — and
-re-running it after an upgrade replaces the old copy. The skill describes what this CLI does,
-which tool to prefer when the project already generates media another way, and the rules that
-keep a paid request from being wasted.
+Working from an agent? Inside pi, install the skill as a pi package:
+
+```bash
+pi install npm:@yandy0725/mediagen-cli
+```
+
+That delivers `skills/mediagen/SKILL.md` only: pi never puts the `mediagen` command on
+`PATH`, so the CLI still comes from `npm install -g @yandy0725/mediagen-cli`. For any other
+agent, `mediagen skill install --dir <skills dir>` puts the same file where that agent
+already looks — e.g. `--dir ~/.claude/skills` — and re-running it after an upgrade replaces
+the old copy. Use one route, not both: pi loads skills by name, so the two copies collide — the
+directory you copied wins and pi only reports a `name "mediagen" collision` warning, which
+means a stale copy silently shadows the upgraded package. The skill describes what this CLI
+does, which tool to prefer when the project already generates media another way, and the
+rules that keep a paid request from being wasted.
 
 ---
 

package/README.zh-CN.md

@@ -229,10 +229,18 @@ OpenAI 兼容端点（`compatible-mode`）只在业务空间专属域名上提
 `timeout_seconds` 是**整个轮询窗口**，不是单次请求：建任务与每次轮询各自 60 秒，这样一个挂住
 的请求吃不掉预算；下载另有 600 秒，不计入预算。
 
-在 Agent 里用？`mediagen skill install --dir <技能目录>` 会把这个包自带的
-`skills/mediagen/SKILL.md` 装到你 agent 已经在读的位置（例如 `--dir ~/.claude/skills`），升级后
-重跑一次即可覆盖旧版本。这份技能说明这个 CLI 能做什么、项目已有别的生成工具时该用哪个，
-以及哪些规则能避免白花钱。
+在 Agent 里用？在 pi 里，把这份技能当成 pi 包安装：
+
+```bash
+pi install npm:@yandy0725/mediagen-cli
+```
+
+它只送 `skills/mediagen/SKILL.md`：pi 不会把 `mediagen` 命令放进 `PATH`，命令仍来自
+`npm install -g @yandy0725/mediagen-cli`。其他 agent 用 `mediagen skill install --dir <技能目录>`
+把同一个文件装到它已经在读的位置（例如 `--dir ~/.claude/skills`），升级后重跑一次即可覆盖。
+两条路线只选一条：pi 按技能名加载，两份同名技能会冲突——复制出来的那份胜出，pi 只给一条
+name "mediagen" collision 警告，于是旧副本会静默盖住升级后的包。这份技能说明这个 CLI
+能做什么、项目已有别的生成工具时该用哪个，以及哪些规则能避免白花钱。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yandy0725/mediagen-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Non-interactive image generation and editing, plus short video generation, for agents: qwen-image, doubao/seedream, doubao/seedance, MiniMax H3, files on disk, JSON output.",
   "type": "module",
   "license": "MIT",
@@ -11,7 +11,13 @@
     "dist",
     "skills"
   ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  },
   "keywords": [
+    "pi-package",
     "cli",
     "image",
     "image-generation",

package/skills/mediagen/SKILL.md

@@ -42,6 +42,15 @@ project has, or when the user asks for it by name.
 
 ## Setup, once
 
+This skill carries no binary: `mediagen` must already be on `PATH`, and the pi package that
+delivered this skill does not put it there. If `command -v mediagen` prints nothing:
+
+```bash
+npm install -g @yandy0725/mediagen-cli
+```
+
+Then one pass per machine:
+
 ```bash
 mediagen config show                          # any command writes and validates config.toml on first use
 mediagen login --api-key sk-...               # the key for the default provider; --provider <name> for another