agent-skillguard
Installation
SKILL.md
Skill Risk Check
Use this skill when the user asks whether an agent skill or plugin should be trusted, installed, reviewed, or admitted.
Non-negotiable boundary
Scanning is read-only. Never execute, source, import, install, or enable the target artifact during review. A clean report is not proof that an artifact is safe, and a finding is not proof of malicious intent.
Workflow
- Identify the exact local target and its provenance.
- Run
python <catalog-root>/agent-skillguard/scripts/skillguard.py scan <path> --format markdownbefore any installation step. Use the absolute catalog path when the host does not expand<catalog-root>. - Review every active finding at its exact file and line.
- Separate confirmed behavior, ambiguous behavior, and false positives.
- If a false positive is accepted, suppress only its exact fingerprint, rule ID, and rule version with a concrete reason.
- Re-run the scan and report both active and suppressed counts.
- Stop before installation or permission grants unless the user separately authorized them.
- When evaluating the scanner itself, scan
agent-skillguard/fixtures/positive(expected review findings) andagent-skillguard/fixtures/negative(expected clean result) with the bundled script, and inspectrules/non-coverage.json. The installed plugin package does not ship the upstreamtools/verify_rule_corpus.pyhelper, so do not claim that helper ran; the two fixture scans are the supported local smoke test.