dsh-skill-dev

Guides writing, debugging, and testing SKILL.md files for DeepSeek Harness.

96|8|Updated Aug 13, 2026
One-click install
npx skills add https://github.com/pingfanfan/hello-dsh --skill dsh-skill-dev-pingfanfan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dsh-skill-dev
Source: https://github.com/pingfanfan/hello-dsh/tree/main/examples/skills/dsh-skill-dev
Command: npx skills add https://github.com/pingfanfan/hello-dsh --skill dsh-skill-dev-pingfanfan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a skill for DeepSeek Harness fails silently when frontmatter keys are misspelled, descriptions don't trigger discovery, or files sit in the wrong directory. This Skill encodes the official DSH skill rules so you can author, debug, and verify skills without reading the source packages. ## Core Features & Use Cases - Frontmatter and discovery rules: Covers the minimal SKILL.md format, the five ranked discovery paths (project, custom, user), and the one-level-only scanning limit. - Fail-closed debugging: Explains why camelCase keys like userInvocable cause the entire skill to be discarded, and gives a排查 order for skills that don't appear. - Description and body writing guidance: Shows how to write trigger-oriented descriptions starting with "when to use", and how to structure the body as judgment criteria with positive/negative examples. - Use Case: You created a new skill but the model never loads it. Use this Skill to check kebab-case frontmatter keys, verify the discovery path, and run the three-step self-test (listed, triggered, behavior changed). ## Quick Start Help me write a new DSH skill that reviews code changes, and check why my existing skill is not being discovered.

Frequently Asked Questions about dsh-skill-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a skill for DeepSeek Harness?▼

Create a SKILL.md file with YAML frontmatter containing name and description, placed in ~/.dsh/skills/<name>/ or a project .dsh/skills directory. The description should start with when to use it, and the body contains instructions loaded by the model.

Why is my DSH skill not being discovered?▼

Check frontmatter key names first: they must be kebab-case like user-invocable, because camelCase keys cause the entire skill to be silently discarded. Then verify the file sits in a scanned discovery path, since nested directories are not scanned.

When should I write a skill versus a plugin in DSH?▼

Choose a skill when you can express the behavior in natural language, such as changing model judgment, output format, or workflow. Choose a TypeScript plugin when you need new tools, external services, UI changes, or lifecycle hooks.

Do DSH skill changes require restarting the session?▼

No. The body is re-read on every load, and the skill directory is re-snapshotted at each agent pre-step, so skills created mid-session are discovered in the same run. Changes under references, scripts, or assets do not trigger rediscovery.

What frontmatter values are valid in a DSH skill?▼

Boolean fields accept true, false, yes, no, on, off, 1, or 0 case-insensitively. Invalid values like maybe cause the whole skill to be dropped, which is an intentional fail-closed safety design.