dsh-plugin-local-utilities

DeepSeek Harness Cordis plugin for local utility features.

This repository is not a Codex plugin package and does not contain a local skill bundle. It intentionally has no .codex-plugin/plugin.json, no skills/ directory, and no bundled SKILL.md. Instead, it registers a DeepSeek Harness Cordis plugin that can import external GitHub or Markdown SKILL.md files into the Harness skill registry.

It currently provides:

• Windows completion notifications when a root agent becomes idle.
• External GitHub or Markdown skill imports through the Harness ctx.skills registry.

The plugin is loaded by DeepSeek Harness with a cordis.yml patch and does not modify Harness core code.

Requirements

• A DeepSeek Harness developer checkout.
• Node.js ^22.19.0 || >=24.0.0.
• pnpm.
• Windows for desktop completion notifications.
• Network access to api.github.com when loading GitHub-hosted skills.
• A Harness profile that includes the skill consumer, such as the standard Web profile with the built-in skill tool.

Install Dependencies

Install this plugin repository's dependencies before loading src/index.ts from Harness:

cd C:\path\to\dsh-plugin-local-utilities
pnpm.cmd install

Harness imports this plugin from a file:///.../src/index.ts URL. The plugin repository therefore needs its own node_modules/ so imports such as @deepseek-ai/dsh-skill resolve correctly.

Local Harness Usage

Create a local patch file from the example and edit the plugin path:

cd C:\path\to\dsh-plugin-local-utilities
copy cordis.example.yml cordis.local.yml

In cordis.local.yml, replace the placeholder name with the absolute file:/// URL for this repository's src/index.ts:

- insert:
    - id: local-utilities
      name: 'file:///C:/absolute/path/to/dsh-plugin-local-utilities/src/index.ts'
      config:
        externalSkills:
          - name: khazix-writer
            description: Write in a natural human style with less mechanical phrasing.
            url: https://github.com/KKKKhazix/khazix-skills/tree/main/khazix-writer
            whenToUse: Use when the user asks for natural, human-like writing.