skill-scanner

Scan agent skill directories for prompt injection, secrets, and supply chain risks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/promptlylabs/skills --skill skill-scanner-promptlylabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-scanner
Source: https://github.com/promptlylabs/skills/tree/main/plugins/promptly-skills/skills/skill-scanner
Command: npx skills add https://github.com/promptlylabs/skills --skill skill-scanner-promptlylabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Scan agent skills to identify security issues before adoption, including prompt injection, dangerous code, secret exposure, and excessive permissions.

Core Features & Use Cases

  • Frontmatter validation of SKILL.md and keyword extraction
  • Analysis of SKILL.md, references, and bundled scripts to detect risks and policy violations
  • Generate structured findings and risk signals for human review

Quick Start

Run the built-in scanner on a skill directory using uv run ${CLAUDE_SKILL_ROOT}/scripts/scan_skill.py <skill-directory>.

Frequently Asked Questions about skill-scanner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan agent skills for prompt injection and malicious code?

To scan agent skills for prompt injection and malicious code, run the built-in scanner on a skill directory using uv run ${CLAUDE_SKILL_ROOT}/scripts/scan_skill.py <skill-directory>. It analyzes SKILL.md, references, and bundled scripts to detect security risks before adoption.

What security issues should I check for before adopting agent skills?

Before adopting agent skills, check for prompt injection, dangerous code, secret exposure, excessive permissions, and supply chain risks. Scanning also enforces frontmatter validation, obfuscation checks, and URL extraction to generate structured findings for human review.

Does the agent skill scanner detect supply chain risks and obfuscated code?

Yes, the agent skill scanner detects supply chain risks and performs obfuscation checks by analyzing bundled scripts and references. It applies risk assessment of permissions and scripts to identify dangerous code patterns and potential malicious payloads.

Can I use this scanner to validate SKILL.md frontmatter and detect exposed secrets?

You can validate SKILL.md frontmatter and detect exposed secrets by running the scanner script. It enforces frontmatter validation and applies secret detection techniques across skill directories to extract keywords and identify sensitive data exposure.

What dependencies do I need to run static analysis on agent skills?

You need pyyaml installed and uv to execute the scanner script for static analysis on agent skills. The scanner processes skill directories containing SKILL.md files, references, and scripts to generate structured findings and risk signals.

How does static analysis identify prompt injection in SKILL.md files?

Static analysis identifies prompt injection in SKILL.md files by applying prompt-injection analysis and risk assessment of permissions. The scanner evaluates frontmatter, extracts URLs, and checks for obfuscation to generate structured findings for human review.