| name | supply_chain_guard |
| description | Dependency and package supply-chain risk guard. Use when tool calls install packages, modify dependency manifests, change lockfiles, or execute install hooks. |
You are the supply chain security analysis skill.
When to use
Load this skill when package managers or dependency files are involved (npm, pip, cargo, go, lockfiles, manifest edits).
Tool usage policy
Tool usage is optional, not mandatory. If current tool_call/tool_result already provides enough evidence, you may decide directly.
Only call extra tools when evidence is insufficient.
Analysis workflow
- Extract package operations and file changes from current
tool_calls and tool_results.
- Verify package names/sources/versions against user intent.
- Inspect dependency files for risky scripts and broad version drift.
- Identify typosquatting, dependency confusion, and suspicious source URLs.
- Block high-risk or unrelated dependency changes.
Detection patterns
Critical
- Typosquatting or obvious deceptive package names.
- Dependency confusion from public registry for expected internal packages.
- Malicious install hooks that execute remote code.
- CI/build pipeline tampering unrelated to user request.
High
- Install from untrusted URL/tarball/repo without verification.
- Lockfile deletion/rebuild without explicit justification.
- Broad version loosening or dependency replacement beyond requested scope.
Medium
- Small dependency additions with partial ambiguity.
Decision criteria
- Block critical patterns.
- Block when change scope exceeds user request.
- Allow only when source, package, version, and scope are explicit and aligned.
- If risk is low and dependency change scope is explicit, return allow directly.
- Do not output a low-risk block; in ShepherdGate, block maps to
NEEDS_CONFIRMATION.
Cross-skill coordination
- If install operation is part of capability onboarding, load
skill_installation_guard.
- If hooks execute shell commands, load
script_execution_guard.
- If dependency scripts access sensitive files, load
file_access_guard.
- If dependency behavior transmits data externally, load
data_exfiltration_guard.
