@dawn0608/dsh-skill-manager 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dawn0608
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# Skill Management
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+English | [中文](README.zh.md)
+
+Open **Skills** below **Plugins** in the DeepSeek Harness sidebar. Search the global catalog by name or description. Open a skill to see its description and rendered `SKILL.md`, with its provenance badge or repository link beside the title.
+
+## Manage skills
+
+- The catalog groups skills as Built-in, Self-authored, and Third-party. Skills with unconfirmed provenance appear under Third-party.
+- For shared skills, record provenance in `~/.agents/skills/.provenance.json` (or under `$DSH_AGENTS_HOME/skills`). Use the instruction file path relative to the skills root, such as `my-skill/SKILL.md`, as the key. Set `origin` to `self` or `third-party`. For a third-party skill, an optional credential-free HTTPS `repository` URL appears as a link in the detail view.
+- For a copy previously imported and managed by the plugin, use the switch in the list or detail view to enable or disable it, or uninstall it from the detail view. Managed copies live under `$DSH_HOME/skill-manager/bundles` and are activated in `$DSH_HOME/skills` for profiles using that home.
+
+## Install
+
+Requires DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`. In Desktop, open **Plugins → Add plugin** and enter `@dawn0608/dsh-skill-manager`. You can also install it with the CLI.
+
+```bash
+dsh plugin --profile <profile> add @dawn0608/dsh-skill-manager
+```
+
+To switch from a local checkout, remove the existing installation before adding the npm package. Restart Harness if prompted. To keep installing from source, run `npm ci` and `npm run build --workspace @dawn0608/dsh-skill-manager` at the repository root, then add the absolute path of `plugins/skill-manager` in Desktop.
+
+## Optional shared skill sync on macOS
+
+The optional user service synchronizes enablement for shared global skills across Harness, Codex, and Claude Code. It runs at login and can handle Codex and Claude Code changes while Harness is closed. Set it up from a persistent checkout of the matching source release, with `node` and `codex` on your PATH. [Source release](https://github.com/dawn0608/dsh-plugins/tree/skill-manager-v0.1.1)
+
+```bash
+git clone --branch skill-manager-v0.1.1 https://github.com/dawn0608/dsh-plugins.git
+cd dsh-plugins
+npm ci
+node scripts/install-skill-sync.mjs
+```
+
+The installer configures a user LaunchAgent and Claude Code hooks, backs up existing Codex and Claude Code settings, and prints the backup path. Restart Harness and reopen Claude Code sessions to register their working directories.
+
+Put shared skills in `~/.agents/skills/<name>/SKILL.md`, matching the folder and skill name. The service maintains the Claude Code symlink. Use Harness **Skills**, Codex **Skills**, or Claude Code’s `/skills` to toggle a shared skill. For Claude Code, synchronization covers fully enabled and disabled states. Harness reports conflicts with a matching name in another location. If an open Codex desktop window still shows the previous state, restart it to reload the settings.

package/README.zh.md

@@ -0,0 +1,36 @@
+# 技能管理
+
+[English](README.md) | 中文
+
+在 DeepSeek Harness 左侧边栏的「插件」下方打开「技能」。可按名称或描述搜索全局技能。点击技能可查看描述和渲染后的 `SKILL.md`，并在标题旁查看归属标签或仓库链接。
+
+## 管理技能
+
+- 目录按内置技能、自建技能和第三方技能分组。归属待确认的技能暂列第三方。
+- 共享技能的归属记录在 `~/.agents/skills/.provenance.json`（或 `$DSH_AGENTS_HOME/skills` 下）。以说明文件相对技能根目录的路径为键，例如 `my-skill/SKILL.md`，将 `origin` 设为 `self` 或 `third-party`。第三方技能可填写不含凭据的 HTTPS `repository` 地址，详情页会将其显示为链接。
+- 此前由插件导入的受管副本可在列表或详情页启停，也可在详情页卸载。受管副本保存在 `$DSH_HOME/skill-manager/bundles`，通过 `$DSH_HOME/skills` 为使用同一主目录的 Harness profile 启用。
+
+## 安装
+
+适用于 DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`。在 Desktop 打开「插件 → 添加插件」，输入 `@dawn0608/dsh-skill-manager`。也可以通过 CLI 安装。
+
+```bash
+dsh plugin --profile <profile> add @dawn0608/dsh-skill-manager
+```
+
+从本地源码切换到 npm 包时，先移除已有安装，再添加 npm 包，并按提示重启。若继续使用源码安装，在仓库根目录运行 `npm ci` 和 `npm run build --workspace @dawn0608/dsh-skill-manager`，然后在 Desktop 添加 `plugins/skill-manager` 的绝对路径。
+
+## macOS 可选设置：同步共享技能
+
+用户级后台可同步 Harness、Codex 和 Claude Code 中共享全局技能的启停状态。后台随登录启动，在 Harness 关闭时也能处理 Codex 和 Claude Code 的变更。请在长期保留的对应版本源码目录中设置，并确保 PATH 中能找到 `node` 和 `codex`。[对应版本源码](https://github.com/dawn0608/dsh-plugins/tree/skill-manager-v0.1.1)
+
+```bash
+git clone --branch skill-manager-v0.1.1 https://github.com/dawn0608/dsh-plugins.git
+cd dsh-plugins
+npm ci
+node scripts/install-skill-sync.mjs
+```
+
+安装脚本会配置用户级 LaunchAgent 和 Claude Code hooks，备份已有的 Codex 和 Claude Code 配置，并输出备份路径。随后重启 Harness，并重新打开 Claude Code 会话以登记工作目录。
+
+将共享技能放在 `~/.agents/skills/<name>/SKILL.md`，保持目录名与技能名一致。后台维护 Claude Code 的软链接。可在 Harness「技能」、Codex「技能」或 Claude Code 的 `/skills` 中启停共享技能。Claude Code 侧同步完全启用和完全停用两种状态。遇到其他位置的同名冲突时，Harness 会提示检查。如果已打开的 Codex 桌面仍显示旧状态，重启 Codex 读取更新。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: skill-manager
+      name: '@dawn0608/dsh-skill-manager'

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 36 36" width="36" height="36">
+  <path d="M18 9 27 14v8l-9 5-9-5v-8Z"
+        fill="none" stroke="#527ee8" stroke-width="2" stroke-linejoin="round"/>
+  <path d="m18 13.5 1.5 3 3 1.5-3 1.5-1.5 3-1.5-3-3-1.5 3-1.5Z" fill="#527ee8"/>
+</svg>