SKILL.md
Skill Vetting Skill
A skill is instructions your agent will obey plus scripts your machine will run — installing one is granting authorship over future behavior, and marketplaces host both gems and traps. This skill is the pre-install reading: the red-flag pattern sweep, the blast-radius audit ("what can this touch"), and a tiered verdict with quoted evidence. It's a judgment framework, not a scanner — the point is an informed human decision, and for anything above LOW the human makes it.
What This Skill Produces
- The verdict — 🟢 LOW / 🟡 MEDIUM / 🔴 HIGH / ⛔ REJECT, with the one-paragraph reasoning
- The evidence table — every finding with the quoted line from the skill's own files
- The blast-radius audit — files read/written, network destinations, commands run, credentials touched
- The recommendation — install / install-but-watch / sandbox first / reject, matched to the tier
Required Inputs
Ask for these if not provided:
- The skill's contents — SKILL.md plus everything else in the folder (scripts, references, hooks); a skill vetted by its README alone is not vetted
- The provenance — source (official repo, known author, unknown upload), stars/downloads if visible, last-update date; reputation is a signal, not a verdict — popular skills have carried surprises
- The install context — what the agent it's joining can already do (its permissions are the skill's permissions), and how sensitive the machine is
Framework: The Sweep, the Radius, the Tiering
- The red-flag sweep — patterns that demand explanation: credential/secret access (
~/.ssh,~/.aws,.env, keychain, tokens) · network exfiltration shapes (curl/fetch POSTing local data out, webhooks, pastebins) · obfuscation (base64 blobs, hex payloads, minified one-liners in a "readme") · dynamic execution (eval,exec, piping downloads to shell) · persistence (crontabs, launch agents, shell-rc edits) · instruction-layer attacks (text telling the agent to ignore its rules, hide actions from the user, or auto-approve future prompts) · scope creep (a weather skill touching git config). Each hit gets quoted, located, and — some have legitimate uses; unexplained is the flag.
