dsh-skill-pack-security

Eight security-audit skills plus an automated plugin supply-chain gate for DeepSeek Harness.

The skills teach the audit methodology; the plugin_vet tool executes the pre-install scan — license / SBOM / commit pinning / malicious patterns / five-dimension risk card.

English · 简体中文 · Español · Português · हिन्दी

---

Compatibility

Surface	Status
Harness	DeepSeek Harness 0.1.0-rc.6
Node	^22.19.0 || >=24.0.0 (the DeepSeek Harness runtime)
Platforms	All (the skills are content; the provider is a host plugin)
Model	Any (skills load on demand via the skill tool; plugin_vet is deterministic)

What you get

dsh-skill-pack-security is a skill pack + supply-chain gate for DeepSeek Harness. It ships eight security methodologies as SKILL.md bundles that the model discovers in its session catalog and loads on demand with the skill tool, plus the automated plugin_vet pre-install scanner. The skills teach the methodology; the plugin executes the static checks.

• Eight skills, two editions — every skill ships with identical names and metadata in skills/ (Chinese) and skills-en/ (English); install one language per root.
• plugin_vet gate — a zero-dependency scanner (license / SBOM / commit pinning / malicious patterns / five-dimension risk card) registered by the optional provider/ plugin on ctx.tools.
• Findings cite the skills — every finding points to the matching skill section (for example supply-chain-review §1) so the agent can continue the manual audit.
• Executable by a model — each skill step is a real command (gitleaks, trivy, pnpm audit, npm view, git …) with an expected-output sample and an exit-code criterion.

Why skills, not tools?

Shape	What it does	What it cannot do
Tool plugin (e.g. security scanners)	Executes scans, returns findings	Interpret alerts, tier false positives, write redacted reports
Protocol layer	Constrains a protocol	Generalize across repos and agents
Skill pack (this repo)	Teaches methodology: triage, reporting, remediation order — and automates the static pre-install checks via plugin_vet	Replace a manual audit end to end

Installed together with a tool-type security plugin, the two compose: the tool runs the scan, the skill drives interpretation, triage, and the report. This pack combines both shapes: the skills teach the methodology, and plugin_vet runs the mechanical static subset automatically, with every finding pointing back into the skills.

The Claude Code ecosystem's 3000+ skills prove the distribution value of this shape. DSH's SKILL.md frontmatter (name, description, whenToUse) is format-compatible with CC skills; this pack uses only the common subset and its content is entirely original.

The eight skills

Skill	Purpose	When to use
security-audit	Five-phase audit flow: scope → inventory → risk tiering → verification → report template	Whole-repo audits, audit reports, planning
secret-scan	Credential audit: gitleaks/trivy usage, false-positive tiers, redacted reports, remediation order	Secret scanning, alert triage, leak reports
dependency-audit	Supply-chain audit: pnpm/npm audit reading, licenses, typosquat risk, lockfile drift	Dependency review, audit-report interpretation
supply-chain-review	Quick PR/new-dependency review: dangerous install scripts, typosquat, reproducible builds	Reviewing PRs that add dependencies
prompt-injection-review	Injection-surface review for agent projects: AGENTS.md, skills, tool descriptions, MCP, web	Reviewing model-context injection surfaces
threat-model	Design-stage threat modeling: trust boundaries, STRIDE table, attack trees, mitigations	Modeling new features, design-stage security review
vuln-intel	Vulnerability intelligence: NVD/CISA-KEV/GHSA/OSV lookups with verdict criteria	Given a CVE/GHSA id, checking impact and exploitation
incident-response	Agent-environment incident response: contain → evidence → recover → postmortem	Suspected security incidents in DSH/agent setups

Each bundle keeps its main file ≤ 300 lines (progressive disclosure; details live in references/).

plugin_vet — the automated pre-install gate

plugin_vet is the pack's automated complement: a zero-dependency scanner registered by the provider/ plugin on ctx.tools. Point it at a GitHub owner/repo or a local package path — it downloads the tarball once (timeout + AbortSignal respected), scans within budget limits, and returns a render card.

• License scan — finds the LICENSE file and the license field; NOASSERTION/UNKNOWN/SEE LICENSE IN <file>, a missing file, or a missing field is flagged; common SPDX ids are recognized.
• SBOM — extracts the dependency tree with versions from the lockfile (pnpm/npm/yarn).
• Commit locking — install-manifest refs and workflow actions must be immutable 40-hex commit SHAs; @tag/branch refs are flagged as mutable.
• Malicious patterns — lifecycle scripts (preinstall/install/postinstall), network-exfiltration domains, and obfuscated/encoded payloads in shipped code.
• Five-dimension risk report — license / source / dependencies / build scripts / maintenance, each 0–100, folded into an overall verdict: PASS, WARN, or FAIL.

Install gate. The verdict feeds an installation gate — gate.policy: warn (default, non-blocking) prints a warning on FAIL; gate.policy: deny blocks the installation:

- id: skill-pack-security
  name: '@perrylink/dsh-skill-pack-security-provider'
  config:
    language: en
    vet:
      gate:
        policy: deny   # block installs that fail plugin_vet

Complementary to dsh-plugin-check. The official plugin validator's 36 checks verify a plugin's contract and quality (config schema, effect registration, tool JSON shape); plugin_vet verifies the supply chain of where a plugin comes from. Run both:

	dsh-plugin-check (36 checks)	plugin_vet (this repo)
Question answered	Is this plugin well-formed and contract-compliant?	Is this package safe to install?
Looks at	Plugin code, schema, registrations, tool contracts	LICENSE, lockfile, install refs/actions, lifecycle scripts, exfil/obfuscation, maintenance
Verdict	Pass/fail per check	PASS / WARN / FAIL + gate
When	Plugin development or review	Before dsh plugin add, PR review, CI supply-chain gate
Blocking	CI gate (non-zero on violations)	Configurable: warn (default) or deny

Quick start

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-skill-pack-security#main"

# or from npm (published releases)
dsh plugin --profile web add @perrylink/dsh-skill-pack-security-provider

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: skill-pack-security'

Install & uninstall

• git channel (latest main): dsh plugin --profile web add "github:PerryLink/dsh-skill-pack-security#main" — mounts the provider bundle; prepack embeds both editions into the tarball.
• npm channel (published releases): dsh plugin --profile web add @perrylink/dsh-skill-pack-security-provider.
• tarball channel: pnpm pack in provider/, then dsh plugin --profile web add ./@perrylink-dsh-skill-pack-security-provider-<version>.tgz.
• uninstall: dsh plugin --profile web remove @perrylink/dsh-skill-pack-security-provider (or remove the row; pure-skill copies are removed with the installer's -Uninstall / --uninstall).

Installing the skills by hand

DSH's local skill provider scans four roots by rank (lower rank wins same-name conflicts within a layer):

Rank	Root	Scope
100	<projectRoot>/.dsh/skills	Project-scoped, travels with the repo
200	<projectRoot>/.agents/skills	Project-scoped, shared agent directory
400	<dshHome>/skills ($DSH_HOME or ~/.dsh)	User-scoped, DSH-only
500	<agentsHome>/skills ($DSH_AGENTS_HOME or ~/.agents)	User-scoped, cross-agent

Ranks (lower wins same-name conflicts within a layer): project-dsh 100 < project-agents 200 < custom 300 < user-dsh 400 < user-agents 500. Custom rank 300 is plugin-registered (such as this pack's optional provider/), not a disk root.

./scripts/install.ps1 -Target user-agents -Language zh   # Target: project-dsh | project-agents | user-dsh | user-agents; Language: zh (default) | en

bash ./scripts/install.sh --target user-agents --language en

What's inside

Path	What it is
skills/<name>/SKILL.md	The eight skills (Chinese edition); frontmatter follows the official dsh-skill-filesystem contract
skills-en/<name>/SKILL.md	The eight skills (English edition); same names and metadata as the Chinese edition
skills/<name>/references/	Progressive-disclosure detail: command matrices, triage tables, templates
scripts/install.ps1	One-command Windows installer for all four roots (both language editions); records a manifest, supports -Uninstall/-DryRun/-Force
scripts/install.sh	The POSIX equivalent (--uninstall/--dry-run/--force)
provider/	npm-installable provider bundle (declares dsh.bundle; embeds both editions in pack/ via prepack; language: zh|en); registers the skills provider AND the plugin_vet gate tool via ctx.effect(), fails loud on a bad skillsDir
provider/src/vet/	The zero-dependency plugin_vet scan engine (license / SBOM / commit lock / malicious patterns / risk report)
package.json	Root bundle manifest: declares dsh.bundle.patch (→ provider/cordis.patch.yml) and dshWorkshop intake facts
verify/verify-skill-pack.mts	Headless verification against the official parser, the real skill tool, and the real tools runtime — 25 checks across both editions
VERSION	Single version source; every SKILL.md metadata.version and provider/package.json must match it (CI-enforced)
docs/	Ecosystem conflict check, release checklist, improvement plans, and plugin_vet demos
CHANGELOG.md / SECURITY.md / CONTRIBUTING.md	Release history, vulnerability reporting policy, and contribution/verification rules
.github/workflows/verify.yml	CI: 25-check verification + installer exercise + provider build/pack smoke (Ubuntu and Windows)
.github/dependabot.yml	Weekly dependency updates for the provider and GitHub Actions
LICENSE	Apache License 2.0

Configuration

All tunables are Schemastery Config fields (changeable from cordis.yml). provider/cordis.patch.yml documents each key inline.

Key	Default	Meaning
language	zh	Edition to publish: the Chinese skills/ or the English skills-en/; ignored when skillsDir is set
watch	false	Watch the packaged skills directory (static content, so disabled)
skillsDir	(unset)	Explicit skills root; overrides the language-derived default and must hold <skill>/SKILL.md bundles
vet.enable	true	Register the plugin_vet gate tool
vet.timeoutMs	15000	Tarball-fetch timeout in ms
vet.maxFiles	800	Scan file cap
vet.maxFileBytes	262144	Per-file byte cap
vet.maxExtractBytes	67108864	Extraction byte cap
vet.maxDepNodes	600	Dependency-tree node cap
vet.maxFindingsPerCheck	12	Findings cap per check
vet.userAgent	dsh-skill-pack-security/2.0.0 (+https://github.com/PerryLink/dsh-skill-pack-security)	Fetch user-agent
vet.gate.policy	warn	Install gate: warn (non-blocking) or deny (block on FAIL)

Tools & surfaces

Surface	Kind	Notes
plugin_vet	tool	Pre-install supply-chain scan (license / SBOM / commit lock / malicious / risk card); findings cite skill sections
skill-pack-security	skill provider	Registers the pack's skills/ or skills-en/ edition on ctx.skills
Eight SKILL.md bundles	skills	The audit methodology, in two language editions
install gate	gate	vet.gate.policy: warn | deny feeds installation decisions

Permissions & data

• Permissions: the dshWorkshop manifest declares files:read and network:fetch.
• Data: plugin_vet downloads a tarball once (timeout + AbortSignal respected) and reports redact secret-shaped text; the plugin injects no prompt sections.

Security boundaries

• Zero-dependency engine. plugin_vet uses only node: builtins and relative imports.
• Narrow pre-install gate. Not a general-purpose security-audit tool — deliberately complementary to scanner plugins and the official dsh-plugin-check contract validator.
• Non-blocking by default. The install gate is warn unless you opt into deny.
• Original content. Format-compatible with Claude Code skills, but no copied CC skill content and no skill marketplace.

Verification

verify/verify-skill-pack.mts imports the official dsh-skill-filesystem parser, the real skill tool, and the real tools runtime from a local deepseek-harness checkout and asserts 25 checks over both language editions:

1. Layout: both editions present, 8 directory bundles each, no stray flat skills, frontmatter name matches directory, ≤ 300 lines, references/ wired, metadata.version synced to the VERSION file
2. No name conflicts with the official .agents/skills/ skills (derived from the checkout at run time) or known community skill packs 3–6. Per edition (Chinese skills/, English skills-en/): registry discovery through the official provider, full ctx.skills.get() loads, the real skill tool returning <skill_content> (unknown/invalid names rejected), and the session catalog containing name + description only — whenToUse stays out of the model catalog (official design)
3. 13 bad-frontmatter fixtures exercise the official fail-closed rules (missing fields, legacy camel-case keys, non-boolean values, non-kebab names, nested dirs, name mismatch); flat-file skills load and nested **/SKILL.md is not discovered
4. The optional provider plugin mounts the Chinese and the English edition via ctx.effect(), disposes cleanly, and rejects misconfiguration (empty or nonexistent skillsDir) 9–15. Self-hardening checks: zh↔en structural parity, references wiring (no dangling/orphan files), provider version sync, documented skill-root ranks vs the official constants, POSIX-portable grep -E patterns, secret self-check, UTF-8-safe release checklist 16–19. plugin_vet through the real tools runtime: it registers on ctx.tools; the compliant fixture passes; the no-license fixture fails and cites dependency-audit §3; the malicious postinstall fixture fails (scripts/exfil/obfuscation, citing supply-chain-review §1); the gate blocks installation under policy: deny
5. The scan engine is zero-dependency (node: builtins and relative imports only)
6. Report redaction keeps secret-shaped text out of rendered output

# local: auto-resolves the harness checkout beside the pack, or point it explicitly
$env:DSH_HARNESS_CHECKOUT = 'D:\deepseek-harness'
& D:\deepseek-harness\node_modules\.bin\tsx.CMD verify\verify-skill-pack.mts
# All 25 checks passed for dsh-skill-pack-security.

The same 25 checks run on GitHub on every push via .github/workflows/verify.yml — on Ubuntu and Windows — plus an install.sh/install.ps1 exercise and a standalone provider build/pack smoke that asserts the tarball carries both embedded editions and the bundle patch.

Known limitations

• Not a full audit tool. plugin_vet is a narrow pre-install trust gate; it cannot replace a manual, end-to-end audit.
• Static scan only. The malicious-pattern and maintenance signals are heuristics over the shipped package, not dynamic analysis.
• One edition per root. Same-name skills in one root resolve by rank, so only one language edition enters a session catalog.

Roadmap

• dsh-skill-pack-data-engineering — data pipelines, data quality, ETL checklists (same template)
• dsh-skill-pack-oss-collab — PR etiquette, issue triage, maintainer workflows
• dsh-skill-pack-performance — profiling methodology, benchmark criteria, regression checklists
• More skills inside this pack (same pure-skill boundary): sbom-lifecycle (SBOM generation/aging/import workflows), pen-test-review (authorized-engagement scoping and report review), compliance-audit (ASVS/NIST-CSF walkthroughs)
• Keep the plugin_vet demo artifacts fresh (docs/demos/run-demos.mjs) and the dsh-plugin-check complement table accurate as the official checker adds checks

Development

pnpm --dir provider run typecheck   # tsc --noEmit
pnpm --dir provider run build       # tsc --noEmitOnError
pnpm --dir provider run prepack     # embeds both skill editions into the tarball
tsx verify/verify-skill-pack.mts    # 25-check headless verification

Topics

dsh, dsh-plugin, deepseek-harness, skill-pack, skills, security, security-audit, supply-chain, supply-chain-security, prompt-injection

Contributors

• @PerryLink — author and maintainer: the eight skills in both language editions, the installers, the verification suite, the provider bundle, CI, and the documentation.

PerryLink DSH Plugin Family

This project is one of the DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:

Plugin	One-liner
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH

License

Apache License 2.0 © 2026 dsh-skill-pack-security contributors