skill-scanner

Scan agent skill directories for security vulnerabilities and output structured JSON.

Updated May 5, 2026
One-click install
npx skills add https://github.com/iani-kuli/harness_bro --skill skill-scanner-iani-kuli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-scanner
Source: https://github.com/iani-kuli/harness_bro/tree/main/.claude/skills/ported/skill-scanner
Command: npx skills add https://github.com/iani-kuli/harness_bro --skill skill-scanner-iani-kuli

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill mitigates the risk of adopting untrusted agent skills by automatically scanning them for prompt injection, malicious code, and excessive permission requests before they are executed.

Core Features & Use Cases

  • Security Auditing: Detects prompt injection patterns, hardcoded secrets, and dangerous shell commands in skill scripts.
  • Permission Analysis: Evaluates tool access against the principle of least privilege to prevent over-permissioned agents.
  • Supply Chain Protection: Identifies suspicious remote URL fetching and hidden structural attacks like symlink exfiltration or npm lifecycle hooks.

Quick Start

Use the skill-scanner to audit the security of the skill located in the directory named target-skill.

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, you can use a static analysis scanner to audit SKILL.md files and bundled scripts. This process detects hardcoded secrets, dangerous shell commands, and excessive tool permissions before execution.

Do I need the uv CLI to perform static analysis on agent skills?

Yes, you need the uv CLI for Python package management to run the static analysis scanner. It requires the pyyaml dependency to parse configuration files and evaluate agent skill directories for security vulnerabilities.

What is supply chain protection for agent skills?

Supply chain protection for agent skills is the process of identifying suspicious remote URL fetching and hidden structural attacks like symlink exfiltration or npm lifecycle hooks. It prevents untrusted skills from compromising your system during execution.

How do I audit tool permissions for the principle of least privilege?

To audit tool permissions for the principle of least privilege, you run a static analysis scanner on the target skill directory. The scanner evaluates requested tool access against minimal requirements and provides structured JSON output detailing over-permissioned agents.

Can I get structured JSON output from an agent skill security audit?

Yes, you can get structured JSON output from an agent skill security audit. The scanner evaluates SKILL.md files and bundled scripts, returning structured JSON data that details detected prompt injection patterns, credential exposure, and excessive permission requests.

What types of security vulnerabilities can a skill scanner detect?

A skill scanner can detect security vulnerabilities including prompt injection patterns, hardcoded secrets, dangerous shell commands, and excessive tool permissions. It also identifies suspicious remote URL fetching and structural attacks like symlink exfiltration.