Skip to content

feat(skills): package 8 Socket supply-chain skills#499

Merged
JAORMX merged 1 commit into
mainfrom
skills/socketdev
Apr 20, 2026
Merged

feat(skills): package 8 Socket supply-chain skills#499
JAORMX merged 1 commit into
mainfrom
skills/socketdev

Conversation

@JAORMX
Copy link
Copy Markdown
Collaborator

@JAORMX JAORMX commented Apr 20, 2026

Summary

Packages 8 supply-chain security skills from SocketDev/skills (MIT) into Dockyard. All skills pinned to upstream commit 25879b0 (main as of 2026-04-02).

Third vendor in the per-vendor skills sweep after #466 (Trail of Bits) and #498 (Sentry). Socket.dev is a first-party supply-chain security vendor; this pack complements Dockyard's existing supply-chain-risk-auditor.

Tracks #476.

Skills added

Scanning and inspection

  • socket-scan — dependency scan with SBOM, vulnerabilities, malware, license audit; cdxgen fallback for unauthenticated users
  • socket-inspect — research a package before adoption — Socket scores, alerts, CVEs, dependency tree, alternatives

Setup

  • socket-setup — install and authenticate the Socket CLI, sfw, socket-patch; configure CI (GitHub/GitLab/Bitbucket) and Dockerfile integration

Dependency fixing (umbrella + 4 sub-skills)

  • socket-fix — orchestrator (Fix All tiered Conservative/Cautious/Full, or Fix Package)
  • socket-dep-cleanup — evaluate and remove a single unused dependency
  • socket-dep-patch — apply Socket binary-level patches without version changes
  • socket-dep-replace — swap a dependency for an alternative, inline, or socket-optimize
  • socket-dep-upgradesocket fix with one-at-a-time version bumps and code migration

Shared-file note

The socket-fix sub-skills reference skills/_shared/verify-build.md in the upstream repo. The dockyard OCI packager only bundles files under spec.path, so that shared reference file does not ship with the per-skill artifact. The skills remain functional from their own SKILL.md; the shared file is supplementary guidance. If this turns out to be a common pattern across future vendors, we may want to package _shared dirs as additional bundled resources or a dedicated skill.

Security allowlists

All 8 skills carry MANIFEST_MISSING_LICENSE (INFO) — upstream is MIT at the repo root rather than as an SPDX identifier in per-skill SKILL.md frontmatter.

socket-setup additionally allowlists PIPELINE_TAINT_FLOW (LOW): the skill's prerequisites cite the official nvm installer (curl -o- .../install.sh | bash) as a documentation example. The scanner itself flags the finding as "uses a well-known installer URL — likely a standard installation."

Test plan

  • task validate-skill on all 8 specs — all VALID
  • Cisco AI Defense skill-scanner 2.0.9 against all 8 sources — all pass after allowlist
  • CI: Build Skill Artifacts workflow succeeds on this PR
  • CI: skill-scan-report surfaces only allowlisted findings
  • Post-merge: 8 OCI artifacts published under ghcr.io/stacklok/dockyard/skills/<name>:0.1.0

Closes #476

Packages 8 supply-chain security skills from SocketDev/skills (MIT) into
Dockyard, all pinned to upstream commit 25879b0 (main as of 2026-04-02).

Third vendor in the per-vendor skills sweep after #466 (Trail of Bits)
and #498 (Sentry). Socket.dev is a supply-chain security vendor; these
skills complement Dockyard's existing supply-chain-risk-auditor.

Scanning and inspection:
- socket-scan — SBOM, vuln, malware, license audit + cdxgen fallback
- socket-inspect — package-research workflow (scores, alerts, CVEs, alts)

Setup:
- socket-setup — CLI install, auth, CI and Dockerfile integration

Dependency fixing (socket-fix umbrella + 4 sub-skills):
- socket-fix — orchestrator (Fix All tiered / Fix Package modes)
- socket-dep-cleanup — remove a single unused dependency
- socket-dep-patch — apply Socket binary-level patches in place
- socket-dep-replace — swap or inline a dependency
- socket-dep-upgrade — socket fix with one-at-a-time version bumps

Note: the socket-fix sub-skills reference `skills/_shared/verify-build.md`
from the upstream repo. The OCI packager only bundles files under
spec.path, so that shared reference file will not ship with the artifact.
The skills still work from their SKILL.md; the shared reference is
supplementary guidance.

Security allowlists:
All 8 skills carry MANIFEST_MISSING_LICENSE — upstream is MIT at the
repo root rather than per-skill SPDX in SKILL.md frontmatter.

socket-setup also allowlists PIPELINE_TAINT_FLOW: the skill's
prerequisites cite the official nvm installer (`curl ... | bash`) as a
documentation example. The scanner itself flags it as 'uses a
well-known installer URL — likely a standard installation'.

All 8 skills pass `task validate-skill` and `task scan-skill`.

Refs #476
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

🛡️ Skill Security Scan Results

✅ socket-dep-cleanup

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-dep-patch

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-dep-replace

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-dep-upgrade

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-fix

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-inspect

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-scan

  • Status: Passed
  • Findings: 1
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)

✅ socket-setup

  • Status: Passed
  • Findings: 2
  • Allowed (not blocking): 2
    • MANIFEST_MISSING_LICENSE (Allowed: SocketDev/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter.)
    • PIPELINE_TAINT_FLOW (Allowed: The skill's prerequisites cite the official nvm installer command curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/.../install.sh | bash as documentation. The scanner itself flags it as 'uses a well-known installer URL — likely a standard installation'.)

Summary: Scanned 8 skill(s), all passed security checks. ✅

@JAORMX JAORMX added the skills Skill packaging, vendor skill imports label Apr 20, 2026
@JAORMX JAORMX merged commit 052e006 into main Apr 20, 2026
29 checks passed
@JAORMX JAORMX deleted the skills/socketdev branch April 20, 2026 10:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skills Skill packaging, vendor skill imports

Projects

None yet

Development

Successfully merging this pull request may close these issues.

skill: package SocketDev/skills into dockyard

2 participants