poc-weaponization
Installation
SKILL.md
PoC Artifact Review
Review a PoC as untrusted code and produce a concrete assessment-preparation decision. For CVE identity, affected ranges, and asset applicability, use CVE inventory and triage.
For a new vulnerability hypothesis, root-cause investigation, or patch interpretation, use vuln-research.
Review workflow
- Identify the exact artifact: source URL and immutable revision/release when available, file path, retrieval or creation date, claimed CVE/product/version, and SHA-256 digest. For local/generated code, record its source inputs and creation context; do not invent upstream provenance. If a trusted publisher provides a signature, verify it against a separately trusted key. A matching digest identifies bytes; a signature or provenance statement supports origin/integrity claims. Neither establishes that the code is safe. See SLSA artifact verification and NIST SSDF.
- Inspect the intended entry point and relevant source, build files, manifests, lockfiles, helpers and workflow configuration without invoking them. Distinguish declared dependencies from the exact artifacts resolved for the intended runtime/platform, including transitive dependencies and install/build hooks. Record package source, immutable version/digest where available, unresolved ranges, platform-specific branches and uninspected artifacts. A pinned top-level package does not establish the full executed dependency graph. Do not install or invoke public setup/build hooks during static review; treat a needed but opaque execution path as unresolved coverage.
- Trace behavior from entry point through subprocess, filesystem, network, and privilege-sensitive operations. Load PoC review indicators for the focused checklist. Distinguish observed code paths from suspicious names or patterns; static review cannot prove benign behavior, especially for opaque binaries, dynamic loading, and behavior dependent on runtime inputs.
- Compare the artifact's claimed target and conditions with the authoritative vendor/CNA record and local asset evidence. A public PoC's existence or apparent success message does not establish that the assessed product is vulnerable.
- Decide whether a check is useful and bounded. A reviewed, non-destructive diagnostic path may be adapted for portability, bytes handling, library contracts, timeouts, or bounded input validation. Keep the original artifact unchanged; record the adapted file's separate digest and exact changes. Do not construct exploit payloads or add command execution, callbacks, data collection, persistence, or unrelated network access. When adapting would cross these limits, use a separate harmless fixture or vendor-supported check instead.
- When execution is part of the requested work, run only the reviewed non-destructive check or separate fixture in a disposable isolated environment with synthetic data, no credentials, no production connectivity, and no route to unrelated hosts. Before running it, record expected observations, positive and negative/control cases, input and time bounds, side effects to monitor, stop conditions, and cleanup. Do not run unreviewed installers, hooks, opaque or unsafe code paths. Stop if observed behavior differs from the declared check, exceeds bounds, or touches undeclared resources. Record which runtime paths actually ran; a workflow file or hook definition does not establish execution.
- Report review stage separately from concerns:
static-only,check-planned, orcheck-run; then describe suspicious behavior, unresolved coverage and the check's result. Call a bounded diagnostic confirmed only when its expected observation and relevant controls support that conclusion. A success banner or a positive result also returned for the negative control is not discriminating evidence. A negative result, timeout, unreachable service or blocked request does not prove the software unaffected or artifact safe. A static review can both identify suspicious behavior and leave other paths unresolved.
Before calling a result reproducible, freeze the reviewed artifact and invocation, restore or recreate the recorded initial state, and repeat the check with its controls (POCSmith replay contract). Bind fresh observations to that replay; a prior log or caller-supplied status cannot confirm the rerun. Record replay failure or unavailable reset separately from the initial result.