Introduction

The core design philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” When building agents, obtaining, validating, and version-managing Agent Skills are common pain points. Manually screening and validating skill files is time-consuming and may introduce formatting errors or unstable sources.

Awesome DeepSeek Skills is a community project designed to provide DSH with a browsable and installable curated catalog of Agent Skills. Instead of scraping the entire internet, it relies on manual curation and static validation to provide a set of structurally validated skill listings. Each entry is locked to a specific Git commit to ensure reproducible environments.

Plugin Overview

  • Name: Awesome DeepSeek Skills
  • Owner: Whning0513
  • License: MIT
  • Purpose: A curated skill catalog plugin for DeepSeek Harness

This plugin addresses untrusted skill sources, difficulty locking versions, and lack of format validation. It supports offline browsing and restricts the installation process to specific commit hashes to prevent unintended updates.

Core Features

  1. Browse and Install: Directly browse and install skills from the catalog in DSH using the tools provided by the plugin.
  2. Offline Listing: After installation, the skill list is bundled with the plugin, allowing you to search for available skills without an internet connection.
  3. Static Validation: Before installation, the skill structure is statically checked to ensure compliance with DeepSeek/DSH compatibility specifications.
  4. Source Locking: The installer checks out the exact commit specified in the catalog, instead of pulling the latest main branch.

Installation and Activation

Before installing, make sure DeepSeek Harness is installed and your environment is properly configured. Replace demo in the command with the DSH profile name you actually use.

dsh plugin --profile demo add github:Whning0513/awesome-deepseek-skills

After installation, you need to restart the DSH process to activate the plugin.

Typical Usage

After installing and restarting DSH, two command tools will be added:

  • deepseek_skills_list: Search for skills in the local list.
  • deepseek_skill_install: Install the selected skill into the current project.

List Available Skills

Call it directly in DSH:

deepseek_skills_list

Install a Specific Skill

Use the installation command to specify the skill ID and target path (usually .agents/skills):

deepseek_skill_install obra/superpowers/verification-before-completion

If you need to operate the catalog directly through a Python script (for example, in CI), you can use the following command:

uv sync --locked
uv run python scripts/catalog.py list

Example of installing a specific skill:

uv run python scripts/catalog.py install obra/superpowers/verification-before-completion --target /path/to/project/.agents/skills

Validation Mechanism and Limitations

The “validation” provided by this plugin refers only to static structural checks, not security audits.

Validation Process

Each entry undergoes the following checks before being added to the catalog:
* Parsing using deepseek-skill-doctor.
* Structural pattern validation using skill-validator v1.6.0.
* Detection using the DeepSeek/DSH compatibility configuration file.

Because external link checks depend on real-time network access and are not reproducible, validation is limited to the internal structure of skill files.

Security and Permission Notes

  • No Scripts Executed: The plugin installer only copies files and does not run any scripts inside the skill.
  • No Overwrites: The installer checks whether the target directory exists, refuses to overwrite existing files, and refuses to install skills that contain symbolic links.
  • Source Review: Skills may contain unsafe instructions. Before installation, make sure to review the source code, license, and risk warnings in any relevant reports.

Dependency Requirements

  • Git: The installer relies on Git to check out the exact commit.
  • Python: The DSH plugin itself does not require a Python environment, but if you want to use the Python scripts bundled with the catalog repository (such as catalog.py), a Python environment is required.
  • Node.js: The plugin package requires Node.js version ^22.19.0 || >=24.0.0.

Conclusion

Awesome DeepSeek Skills is a community-maintained skill catalog to help DSH developers quickly and safely introduce structurally validated Agent Skills. All installation records are written to the .deepseek-skills.lock file in the project root to track skill origins.

  • Project Home: https://github.com/Whning0513/awesome-deepseek-skills
  • Catalog Page: https://www.skillhub.cn/plugins/Whning0513/awesome-deepseek-skills