razin 1.3.0

Static Analysis for LLM Agent Skills

Razin - Static analysis for LLM agent skills

Razin is a local scanner for SKILL.md-defined agent skills. It performs static analysis only (no execution) and writes deterministic findings.

Documentation

Full documentation lives at:

• https://theinfosecguy.github.io/razin/

Canonical docs source in this repository:

• docs/

Use this README for quick start only.

Requirements

• Python 3.12+

Install

pip install razin
razin --help

Quick start

Run a scan:

razin scan -r . -o output/

Validate config:

razin validate-config -r .

Common CI gates

# Fail if any high-severity finding exists
razin scan -r . --fail-on high --no-stdout

# Fail if aggregate score is 70 or above
razin scan -r . --fail-on-score 70 --no-stdout

Output formats

# Default per-skill JSON reports
razin scan -r . -o output/ --output-format json

# Add CSV + SARIF exports
razin scan -r . -o output/ --output-format json,csv,sarif

Local development

uv sync --dev
uv run pytest -q
uv run ruff check src tests
uv run mypy src tests

Docs preview and checks:

uv sync --group docs
uv run mkdocs serve
uv run mkdocs build --strict
uv run mdformat --check README.md docs

Where to read more

• Getting started: docs/getting-started.md
• CLI reference: docs/cli-reference.md
• Configuration: docs/configuration.md
• Detectors: docs/detectors.md
• Output formats: docs/output-formats.md
• Docker workflow: docs/docker.md
• CI and exit codes: docs/ci-and-exit-codes.md
• Troubleshooting: docs/troubleshooting.md

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

License

MIT