dsh-skill-importer 0.2.3 → 0.2.5

package/README.md

@@ -1,10 +1,11 @@
 <div align="center">
-  <img src="assets/hero.svg" alt="dsh-skill-importer — Skills, right where you need them" width="100%" />
+  <img src="assets/social-preview.jpg" alt="dsh-skill-importer — Agent Skills, safely migrated" width="100%" />
 
   <br />
 
   <strong>Bring skill management into the DeepSeek Harness Web UI.</strong><br />
-  Import, discover, and invoke skills without a session, model tokens, or approval round-trips.
+  Import, validate, deduplicate, and migrate Agent Skills across DeepSeek Harness, Claude Code, Codex, and other AI coding agents.<br />
+  Discover and invoke them without a session, model tokens, or approval round-trips.
 
   <br /><br />
 
@@ -28,6 +29,13 @@
 | :--- | :--- | :--- |
 | Upload `SKILL.md`, paste a URL, or migrate a complete skills directory from Claude Code, Codex, and similar agents. | Browse skills grouped across project and global roots. Remove any copy individually. | Use the composer picker, run `/skills`, or type `/skill-name` directly. |
 
+### See it in action
+
+| `/skills` command | Composer picker |
+| :---: | :---: |
+| <img src="assets/screenshots/skills-command.png" alt="Choose a skill from the /skills command" width="100%" /> | <img src="assets/screenshots/composer-picker.png" alt="Choose a skill from the composer picker" width="100%" /> |
+| Choose a skill from the command palette without leaving the composer. | Open the skill library from the composer footer and insert it in one click. |
+
 ### Built for a fast loop
 
 - **No agent or session** — the host writes skill files directly.
@@ -75,7 +83,7 @@ Existing users can run the same command to update:
 npx @deepseek-ai/dsh plugin --profile web add dsh-skill-importer@latest
 ```
 
-Updating replaces only the plugin package. It does not remove project skills in `.agents/skills` or global skills in `~/.dsh/skills`. Restart dsh Web after updating.
+Updating replaces only the plugin package. It does not remove skills from `.dsh/skills`, `.agents/skills`, `~/.dsh/skills`, or `~/.agents/skills`. Restart dsh Web after updating.
 
 Check the latest published version:
 
@@ -133,12 +141,16 @@ Markdown file or URL
 skills/change → hot refresh
 ```
 
-POST routes verify the `Origin` header and only accept loopback sources (`127.0.0.1` or `localhost`). Writes are restricted to these standard roots:
+POST routes verify the `Origin` header and only accept loopback sources (`127.0.0.1` or `localhost`). Writes are restricted to four default writable DSH roots:
 
-| Scope | Directory |
-| :--- | :--- |
-| Project | `.agents/skills` |
-| Global | `~/.dsh/skills` |
+| Writable target order | Scope | Directory |
+| :---: | :--- | :--- |
+| 1/4 | DSH project | `.dsh/skills` |
+| 2/4 | Shared project | `.agents/skills` |
+| 3/4 | DSH global | `~/.dsh/skills` |
+| 4/4 | Shared global | `~/.agents/skills` |
+
+Lower numbers win among these four writable import targets. DSH-configured `customSkillDirs` sit between project and global roots in the full discovery order, but have no single stable write destination and therefore are not import targets. Bundled skills ship with DSH and cannot be overwritten by the plugin.
 
 ## Development
 

package/README.zh.md

@@ -1,9 +1,10 @@
 <div align="center">
-  <img src="assets/hero.svg" alt="dsh-skill-importer — 在需要的地方，调用你的技能" width="100%" />
+  <img src="assets/social-preview.jpg" alt="dsh-skill-importer — 安全迁移 Agent Skills" width="100%" />
 
   <br />
 
   <strong>把技能管理带进 DeepSeek Harness Web UI。</strong><br />
+  在 DeepSeek Harness、Claude Code、Codex 等 AI 编程 Agent 之间导入、校验、去重和迁移技能。<br />
   无需会话、不耗模型 Token、没有审批往返，导入后立即可用。
 
   <br /><br />
@@ -28,6 +29,13 @@
 | :--- | :--- | :--- |
 | 上传 `SKILL.md`、粘贴 URL，或从 Claude Code、Codex 等 Agent 的技能目录完整迁移。 | 按项目和全局目录分组查看，每个副本都能独立删除。 | 使用输入框选择器、运行 `/skills`，或直接输入 `/skill-name`。 |
 
+### 实际使用效果
+
+| `/skills` 命令 | 输入框技能选择器 |
+| :---: | :---: |
+| <img src="assets/screenshots/skills-command.png" alt="从 /skills 命令中选择技能" width="100%" /> | <img src="assets/screenshots/composer-picker.png" alt="从输入框下方的技能选择器中选择技能" width="100%" /> |
+| 无需离开输入框，直接从命令面板选择技能。 | 从输入框下方打开技能库，一键插入所选技能。 |
+
 ### 为高速工作流而生
 
 - **无需 Agent 或会话** — host 进程直接写入技能文件。
@@ -75,7 +83,7 @@ npx @deepseek-ai/dsh web
 npx @deepseek-ai/dsh plugin --profile web add dsh-skill-importer@latest
 ```
 
-更新只会替换插件包，不会删除 `.agents/skills` 中的项目技能或 `~/.dsh/skills` 中的全局技能。更新后请重启 dsh Web。
+更新只会替换插件包，不会删除 `.dsh/skills`、`.agents/skills`、`~/.dsh/skills` 或 `~/.agents/skills` 中的技能。更新后请重启 dsh Web。
 
 查看 npm 上的最新版本：
 
@@ -133,12 +141,16 @@ Markdown 文件或 URL
 skills/change → 热刷新
 ```
 
-所有 POST 路由都会校验 `Origin`，仅接受 loopback 来源（`127.0.0.1` 或 `localhost`）。写入范围固定为两个标准目录：
+所有 POST 路由都会校验 `Origin`，仅接受 loopback 来源（`127.0.0.1` 或 `localhost`）。写入范围固定为四个 DSH 默认可写目录：
 
-| 范围 | 目录 |
-| :--- | :--- |
-| 项目 | `.agents/skills` |
-| 全局 | `~/.dsh/skills` |
+| 可写目标顺序 | 范围 | 目录 |
+| :---: | :--- | :--- |
+| 1/4 | DSH 项目 | `.dsh/skills` |
+| 2/4 | 通用项目 | `.agents/skills` |
+| 3/4 | DSH 全局 | `~/.dsh/skills` |
+| 4/4 | 通用全局 | `~/.agents/skills` |
+
+数字越小优先级越高，这里仅比较四个可写导入目标。DSH 配置的 `customSkillDirs` 在完整发现顺序中位于项目与全局目录之间，但由于没有统一的写入位置，不作为插件导入目标；Bundled 技能属于 DSH 随附内容，也不允许插件覆盖。
 
 ## 开发