Browse Source

docs(supply-chain-defense): Expand triggers + reframe as routine pre-install check

Make the skill fire on natural install/bump phrasing ("upgrade Harbor to
0.13.0", "pip install foo", "is this package safe"), not just on explicit
attack language. Two changes:

- Frontmatter description gains the explicit reframe ("Use BEFORE every
  install or version bump, not only when an attack is suspected") plus
  the full install/bump trigger list (pip install, uv add, npm install,
  pnpm add, yarn add, cargo add, go get, composer require, gem install,
  upgrade dependency, version bump, before installing, score a package,
  depscore, socket score, etc.).
- Helps-with section opens with a one-sentence reframe so the body
  matches the new framing.

Mirrors the change already landed in ~/.claude/skills (47c9e39).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
0xDarkMatter 1 month ago
parent
commit
b5e1ddab44
1 changed files with 3 additions and 1 deletions
  1. 3 1
      skills/supply-chain-defense/SKILL.md

+ 3 - 1
skills/supply-chain-defense/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: supply-chain-defense
-description: "Behavioural-first software supply chain defense - catches poisoned npm/PyPI packages in the publish-to-advisory window that CVE tools miss. Socket.dev integration (free CLI + GitHub app + depscore MCP for Claude Code), stale-OIDC audit, dependency cooldown policy, publish-token rotation, VS Code extension audit, and a self-integrity scan that detects worm persistence hooks injected into Claude Code / VS Code settings. Triggers on: supply chain, supply chain attack, malicious package, poisoned dependency, npm worm, Shai-Hulud, behavioural scanning, Socket.dev, socket scan, dependency security, postinstall malware, OIDC token theft, compromised maintainer, typosquat, dependency confusion, package provenance, SLSA, persistence hook, malicious VS Code extension."
+description: "Behavioural-first software supply chain defense - catches poisoned npm/PyPI packages in the publish-to-advisory window that CVE tools miss. Use BEFORE every install or version bump (not only when an attack is suspected) - the 7-day cooldown gate + behavioural score catches freshly-published malware that CVE tools won't see for days. Socket.dev integration (free CLI + GitHub app + depscore MCP for Claude Code), stale-OIDC audit, dependency cooldown policy, publish-token rotation, VS Code extension audit, and a self-integrity scan that detects worm persistence hooks injected into Claude Code / VS Code settings. Triggers on: pip install, uv add, uv tool install, npm install, pnpm add, yarn add, cargo add, go get, composer require, gem install, upgrade dependency, dependency upgrade, version bump, bump version, bump package, adding dependency, new dependency, vetting a dependency, vet package, is this package safe, safe to install, should I install, before installing, pre-install check, preinstall scan, preinstall-check, PyPI cooldown, npm cooldown, release cooldown, minimumReleaseAge, score a package, package score, depscore, socket score, supply chain, supply chain attack, malicious package, poisoned dependency, npm worm, Shai-Hulud, behavioural scanning, Socket.dev, socket scan, dependency security, postinstall malware, OIDC token theft, compromised maintainer, typosquat, dependency confusion, package provenance, SLSA, persistence hook, malicious VS Code extension."
 license: MIT
 allowed-tools: "Read Edit Write Bash Glob Grep Agent WebFetch"
 metadata:
@@ -17,6 +17,8 @@ persistence hooks into **Claude Code and VS Code settings** specifically.
 
 ## Helps with
 
+**Every dependency install or version bump is a use case here — not just suspected attacks.** Run the behavioural scan on the way in, before the install, every time.
+
 Deciding whether a dependency you're about to add is safe — getting a behavioural
 verdict on an npm or PyPI package *before* `npm install` / `pip install`, not days
 later when a CVE drops. `socket package score`, the depscore MCP, or