Skip to main content

dsh-reverse-skill

54Stars9Forks1Issues0Watchers

Package all 85 security research skills from upstream reverse-skill for DeepSeek Harness, one-click enable.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
PowerShell
License
MIT
Branch
main
ctfdeepseek-harnessdsh-pluginpentestreverse-engineeringsecurity

Install

cmdweb profile
$ dsh plugin --profile web add @dhicoc/dsh-reverse-skill

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin dhicoc/dsh-reverse-skill for me: review the repository at https://github.com/dhicoc/dsh-reverse-skill first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Pitch

Packages the 85 security research skills (43 domain skills + 42 CTF track skills) from the upstream reverse-skill project as-is into a dsh Cordis plugin. After installation, skills are automatically injected into the skill library when the host starts, eliminating the hassle of manually maintaining a candidate list.

Core Features

  • One-click mounting of 85 reverse engineering/penetration testing/forensics/firmware/mobile/CTF security research skills into the dsh skill library
  • Recursively scans all SKILL.md files under skills/ and CTF-Sandbox-Orchestrator/ directories — adding or removing skills requires no plugin code changes
  • Parses SKILL.md frontmatter (BOM/CRLF compatible), promoting metadata.user-invocable to top-level user-invocable
  • Registers a skill provider under the reverse-skill namespace, callable by both model and user by name
  • Normalizes upstream camelCase fields like when_to_use to dsh-supported whenToUse, preventing dsh from rejecting the load
  • Provides BOM/CRLF fixture self-test script to ensure the scanner doesn't silently skip files with BOM

Technical Implementation

  • Language: TypeScript (ES2022 / NodeNext, compiled to lib/index.js + lib/types/index.d.ts)
  • Key Dependencies: @deepseek-ai/cordis, @deepseek-ai/dsh-skill (peerDependencies, provided by dsh at runtime)
  • Architecture Pattern: Cordis plugin — apply(ctx) calls ctx.skills.registerProvider() to register a data-driven SkillProvider into the host; scanner uses node:fs/promises + node:url + node:path to recursively traverse package directories, results cached in module-level CACHE
  • Entry Point: src/index.ts (exports name = 'reverse-skill', inject = ['skills'], apply(ctx)); at runtime, loaded by dsh via the bundle entry declared in cordis.patch.yml
  • Auxiliary Files: port.py normalizes frontmatter and restructures routing skills into subdirectories when搬运ing the upstream reverse-skill repo to this repo; _selftest.mjs temporarily writes SKILL.md with BOM to verify scanner robustness

Use Cases

When conducting authorized reverse engineering, vulnerability research, CTF competitions, security audits, or penetration testing, you want the model to automatically route to corresponding specialized skills based on task type (e.g., IDA reverse engineering, APK unpacking, JS signature location, AD attack chain reproduction). Also suitable for importing the entire upstream reverse-skill methodology into the dsh workflow at once, avoiding the need to copy SKILL.md files one by one.

Prerequisites & Compatibility

DependencyMinimum VersionDescription
@deepseek-ai/cordis^4.0.1Cordis framework (peerDependency, provided by dsh runtime)
@deepseek-ai/dsh-skill^0.0.1-rc.1dsh skill seam types (peerDependency, provided by dsh runtime)
Node.jsNot declared (repo CI uses Node 22, @types/node ^22.0.0)Source uses ES2022 / NodeNext
PlatformCross-platformOnly uses Node built-in modules (fs, url, path), no native dependencies
Native ModulesNoneNo native bindings like node-pty, node:sqlite

Installation

dsh plugin --profile web add github:dhicoc/dsh-reverse-skill

Configuration

This plugin requires no additional configuration. All behavior is determined by the directory contents of skills/ and CTF-Sandbox-Orchestrator/ in the repo — no schema, no runtime parameters.

FAQ

Q: After installation, I'd like to confirm the skills are actually registered. Is there a command to list all 85 skills?

A: You can run npm install && npm test in the repo root. This command will recompile and assert through the actual registered SkillProvider that all 85 skills can be discovered, have no duplicate names, and return non-empty content from get().

Q: I only want a subset of skills. Can I pick them out individually?

A: The plugin uses directories as the data source and cannot select subsets at runtime. If you only want to use certain skills, you can copy the corresponding subdirectories to the customSkillDirs path and mount them as a preset (the non-plugin fallback solution provided in the README).

Q: If SKILL.md contains allowed-tools / disallowed-tools, will they be enforced?

A: No. dsh currently treats these as unknown fields and delays execution; tool constraints declared in the skill body need to be ensured by yourself at the harness layer.

Q: Where did the upstream agents/*.yaml (OpenAI Agents SDK) configurations go?

A: They've been removed. dsh's ctx.subagent only supports spawning Codex / Claude Code CLI, and cannot map OpenAI Agents SDK definitions; these 43 agent definitions were deliberately not included in the plugin.

Q: Will external MCP servers referenced in skills (burp-mcp, IDA MCP, jshookmcp, etc.) start automatically?

A: No. The plugin only packages SKILL.md and necessary local resources. For external MCP servers, please self-integrate and start them according to dsh's mcp.servers configuration.

Q: Will uninstalling this plugin affect dsh itself?

A: No. This plugin only registers a provider on ctx.skills. After uninstallation, that provider stops exposing skills, and dsh's core functionality is unaffected.

Q: Can I use this on Windows?

A: Yes. The source code only uses Node built-in modules, and port.py is only used during the搬运 phase (directories already on disk don't need to run it again), so it's cross-platform at runtime.

Learning Curve

Beginner — one-line command to install and use, no schema to fill in, no runtime parameters; prerequisite is understanding dsh's own skill invocation process and knowing which scenarios fall within authorized security research.

Known Issues & Limitations

  • allowed-tools / disallowed-tools are not enforced by dsh and must be ensured at the harness layer
  • camelCase frontmatter fields (like when_to_use) have been batch rewritten to whenToUse by port.py; when manually modifying and appending new skills, maintain consistency yourself
  • Upstream agents/*.yaml OpenAI Agents SDK definitions were not ported, as dsh does not support that Agent framework
  • External MCP servers referenced in skill body (burp-mcp, IDA MCP, etc.) are not within the plugin distribution scope and need to be self-integrated
  • Documentation links have been rewritten to ../ and ../../CTF-Sandbox-Orchestrator/ to adapt to dsh's flat mount path

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/dhicoc/dsh-reverse-skill)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory