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.
Requires Go 1.26+, a C compiler, make and pkg-config.
make deps install
export PATH="$HOME/.local/bin:$PATH"
scout doctorMake 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.
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.mdThe 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.
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-pluginSee checks and profiles for categories, limitations and extension examples.
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.
make test-core
make testThe 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