Skip to content
skarmPublic

About

Security Scanner for Agent Skills

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Scout

English · Русский

Scout checks AI agent skills and plugins before installation or updates. It analyzes instructions, configuration, code and supported attachments without executing the inspected package. Use it through the CLI, Go API or MCP.

Install from source

Requires Go 1.26+, a C compiler, make and pkg-config.

make deps install
export PATH="$HOME/.local/bin:$PATH"
scout doctor

Make prepares the native dependencies automatically on supported macOS and Linux platforms. The default installation directory is ~/.local/bin; add it to your shell's PATH once. Scout can then run from any directory. See the build guide for custom installation paths, CI builds and offline preparation.

Scan and compare

scout scan --format markdown ./my-skill
scout scan --format json --fail-on high ./skills ./plugins
scout compare --format markdown ./previous ./candidate
scout discover --scan -- --format markdown
scout scan --input - --name SKILL.md --format json < ./SKILL.md

The default standard profile runs static checks offline. review adds a configured large language model (LLM) and requires source-upload consent. custom lets you choose checks. Downloads and network vulnerability lookup require separate permissions.

Reports retain findings, inspection gaps and the policy decision. Incomplete checks require attention even when no findings were reported. See CLI usage for configuration, report files, baselines and exit codes. The CLI reference lists every flag and default; scout -h prints the complete list in the terminal. Start with ready-to-use configurations for standard review, CI, batch scans, the core build, OSV or LLM review.

Checks and extensions

The full build includes checks for agent instructions and prompt injection, permissions and hooks, MCP configuration, hidden content, dependencies and selected data flows in Go, Shell, JS/TS, Python and SQL. The standard profile also includes adapted SkillSpector rules and embedded YARA-X signatures for malware, webshells, cryptominers, hacktools and agent skill threats.

Without rebuilding, add custom or third-party YARA rules with --yara-rules or a versioned artifact with --rulepack. Enable OSV with --vuln, or connect an LLM through the review profile. Network access and source uploads require separate grants.

scout rules list --all
scout capabilities
scout scan --yara-rules /etc/scout/organization.yar --fail-on medium ./my-plugin

See checks and profiles for categories, limitations and extension examples.

Go API and integrations

Create a Scanner with scout.New(ctx, scout.DefaultOptions()) and release it with Close. Use Scan, ScanMany, ScanEnvironment or Compare. Evaluate the result with a trusted policy.Gate and prepare it for output with report.Prepare. API contracts · Go API example.

Integration guides cover MCP and reviewer bundles for Claude Code, Codex, Pi and OpenCode.

Development

make test-core
make test

The full suite requires native dependencies. make build writes to bin/ by default; override it with BIN_DIR. make clean removes built binaries and temporary working data; installed copies remain available. See validation for other checks.

Contributing · Security policy

Documentation · Examples · Architecture · Languages · Licenses and sources

About

Security Scanner for Agent Skills

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages