Introduction

The philosophy of DSH is “everything is a plugin.” Over time, $DSH_HOME accumulates a significant number of skills, bundle plugins, and market capabilities. These items are scattered across different paths, and since most READMEs are in English, finding “which skill is suitable for doing a specific task” after a period of time often requires searching through directories and chat logs. Two common approaches exist: writing scripts to export the entire environment into a manifest, or manually maintaining notes. The former generates a lot of noise, while the latter is time-consuming; neither addresses the issue of whether the source of the entry is credible or whether the description is accurate.

Below is an introduction to catalog-capabilities-zh. It takes a different approach: a default curated mode where only user-confirmed items are written into the documentation, maintaining a Chinese directory of skills, plugins, and market capabilities with verifiable sources.

What is this

catalog-capabilities-zh is maintained by MeowTnT3r under the MIT license. It is positioned as a public capability directory for Codex and DeepSeek Harness: it orchestrates the currently available trusted installers within the Agent and maintains a Chinese directory of skills, plugins, and market capabilities with verifiable sources.

For DSH users, the repository root directory serves simultaneously as a DSH bundle plugin. Once installed, it registers a runtime skill with the same name and switches the CLI to the --agent dsh adapter.

In its design, it does not rewrite download or installation logic. When installation is explicitly requested, it invokes the trusted installer already available in the current environment—Codex’s skill-installer / plugin management capability, or DSH’s dsh plugin. If the target is already installed, it only verifies and updates the Chinese documentation. If only a link is provided without an intent to install, it only performs a check and provides an introduction.

Core Features

  1. Curated mode is the default. It does not automatically and fully record the current environment; only user-confirmed entries are added to the documentation. Scanning the existing environment serves only as an auxiliary discovery tool, listing skills, plugins, and market paths, as well as the “Skill Package -> Sub-skill” relationship, which are written only after user selection. render --all or --catalog-mode full is required for explicit full recording.

  2. add-source supports manually registering local directories, GitHub, npm, or inline JSON.

  3. There are two documentation modes: package (default, organized by skill package, with sub-skills listed in the package details) and individual (sub-skills are categorized separately).

  4. Entries can be searched by Chinese name, original name, tags, aliases, scope, or trigger words. It also supports natural language filtering and recommending recorded skills, plugins, or market capabilities. Filtering is a read-only operation; installation orchestration only occurs when the user explicitly requests it.

  5. The --agent dsh adapter scans for DSH bundle plugins in $DSH_HOME/skills and $DSH_HOME/profiles/<profile>/node_modules.

  6. inspect-link only reads the README and SKILL.md metadata of public GitHub repositories and does not execute any repository code. discover-links only reads discovered external group links, which can be registered as an independent root directory via --linked-root after user confirmation.

  7. The embedded Python CLI requires Python 3.8+ and uses only the standard library.

Installation and Enabling

It requires pnpm to be in the PATH (as dsh plugin forwards to pnpm). The engines require node >= 18 and dsh >= 0.1.0-rc.6. Execute the following command to install the repository as a plugin into the web profile:

dsh plugin --profile web add github:MeowTnT3r/catalog-capabilities-zh

After installation, restart dsh web, enter $catalog-capabilities-zh in the session, or directly use natural language to request scanning, filtering, or maintaining the Chinese capability directory.

The embedded Python CLI in the plugin uses only the standard library. Python 3.8–3.10 automatically uses the built-in TOML fallback parser and does not require Python 3.11 to be installed.

On Windows, please note one thing: In DSH 0.1.0-rc.6, when forwarding local file parameters on Windows, paths containing spaces may be split into multiple pnpm parameters. If the project is located in such a path, do not use dsh plugin --profile web add .. Instead, run npm pack first, move the generated .tgz file to a path without spaces, and then install:

npm pack
# 将生成的 catalog-capabilities-zh-<version>.tgz 移到无空格路径后：
dsh plugin --profile web add C:\dsh-pack\catalog-capabilities-zh-1.0.0.tgz

GitHub package names, npm package names, and local paths that do not contain spaces are not affected by this rc.6 launcher issue. For standard installation, prioritize using the GitHub command above.

Typical Usage

The most common usage in a session is natural language filtering. For example:

$catalog-capabilities-zh 帮我筛选前端技能
$catalog-capabilities-zh 帮我找适合前端重构和 UI 设计的技能
$catalog-capabilities-zh 有哪些能力可以生成图片或处理 PDF？
$catalog-capabilities-zh 从现有技能里推荐几个适合调试复杂 Bug 的，并说明区别

When filtering, it comprehensively uses the Chinese name, original identifier, function category, tags, aliases, scope, capability effect, and typical trigger words to return the installation status, applicable scenarios, and main restrictions of matching items. By default, it only searches selected curated entries; use search <keyword> --all to search all scan results.

When operating the CLI directly, first discover the environment, then complete the configuration:

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py discover --dsh-home ~/.dsh --format json

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py configure --agent dsh --dsh-home ~/.dsh --dsh-profile web --config ~/.dsh/catalog-capabilities-zh/config.json --catalog ~/.dsh/CAPABILITIES.zh-CN.md

When you only want to learn about a specific repository, use inspect-link to check public repository metadata without executing any code:

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py inspect-link --url https://github.com/owner/repo --format json

System / built-in skills are not recorded by default. When the user explicitly requests it, run scan --include-system first, then select --add <id> to record.

The boundaries of the workflow are clear: when installation is explicitly requested and a target is provided, it orchestrates the trusted installer, verifies, and writes the description; if the target is already installed, it only verifies and writes the description; if only a link is provided without an installation intent, it only checks and provides an introduction. For multi-skill repositories, it first displays a list of candidates and requires selection rather than installing all by default. Existing skills will not be automatically overwritten; when a remote difference is detected, it only prompts for an update.

Configuration and File Locations

The first configuration saves config.json and state.<profile>.json in the system configuration directory:

  • Windows: %APPDATA%\catalog-capabilities-zh\
  • macOS: ~/Library/Application Support/catalog-capabilities-zh/
  • Linux: ${XDG_CONFIG_HOME:-~/.config}/catalog-capabilities-zh/

Setting CAPABILITY_CATALOG_CONFIG can override the configuration file location. The profile only records the scan root directory, documentation location, and options; it does not save account information or tokens.

The DSH runtime skill defaults to placing the configuration at $DSH_HOME/catalog-capabilities-zh/config.json, and the manual at $DSH_HOME/CAPABILITIES.zh-CN.md.

Use Cases and Considerations

It is suitable for DSH users who maintain a large number of skills and plugins and wish to consolidate a Chinese documentation directory. It is also suitable for scenarios where “you look at the introduction before deciding whether to install”—when only a link is provided, it only reads repository metadata to check and introduce; it does not press the “install” button for you.

The security boundaries need to be clear:

  • GitHub README and third-party metadata are read as untrusted data; it does not execute scripts, README commands, or unknown installers within the repository.
  • Installation is still constrained by the Agent’s network access, global directory write access, and account permission approvals.
  • Scanning only enters root directories confirmed by the user; sub-level links are discovered first and then confirmed, and will not be silently followed.
  • Directory updates use file locks, atomic replacement, and a single backup.

Like all DSH plugins, this plugin runs with the permissions of the current dsh process. It is recommended to review the source code and license before installation to ensure it meets your usage requirements.

Summary

The value of catalog-capabilities-zh lies in consolidating “what is installed, what it can do, and where it comes from” into a self-verified Chinese directory, without overstepping to make installation decisions for the user. This is a community project with no official affiliation with DeepSeek or Huanfang.

  • Directory page: https://www.skillhub.cn/plugins/MeowTnT3r/catalog-capabilities-zh
  • GitHub: https://github.com/MeowTnT3r/catalog-capabilities-zh