skill-scanner

Installation
Summary

Automated security scanning for agent skills before installation, detecting prompt injection, malicious code, excessive permissions, and supply chain risks.

  • Runs static analysis via bundled Python scanner that outputs structured JSON findings with severity levels and URLs
  • Validates SKILL.md frontmatter (required fields, tool justification, model overrides) and checks for config poisoning or scope creep in instructions
  • Analyzes scripts for data exfiltration, reverse shells, credential theft, dangerous eval/exec patterns, and unverified dependency sources
  • Distinguishes between legitimate security documentation (discussing injection patterns) and actual malicious execution
  • Provides eight-phase workflow: discovery, automated scan, frontmatter validation, prompt injection analysis, behavioral analysis, script review, supply chain assessment, and permission tier evaluation
SKILL.md
Contains Shell Commands

This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.

Skill Security Scanner

Scan agent skills for security issues before adoption. Detects prompt injection, malicious code, excessive permissions, secret exposure, and supply chain risks.

Requires: The uv CLI for python package management, install guide at https://docs.astral.sh/uv/getting-started/installation/

Important: Run all scripts from the repository root. Script paths like scripts/scan_skill.py are relative to this skill's root directory (the directory containing this SKILL.md), not relative to the target repository.

Bundled Script

scripts/scan_skill.py

Static analysis scanner that detects deterministic patterns. Outputs structured JSON.

uv run scripts/scan_skill.py <skill-directory>

Returns JSON with findings, URLs, structure info, and severity counts. The script catches patterns mechanically — your job is to evaluate intent and filter false positives.

Related skills

More from getsentry/skills

Installs
1.3K
GitHub Stars
692
First Seen
Feb 11, 2026