SKILLディレクトリのLM-agentベースのスキャナー。 Vetixは、妥協と微妙な、難読化された攻撃チェーンの両方の明らかな指標が単一のパスでキャッチされるように、LMの行動アナリストと決定的なプラグインルールをペアリングします。

2018年11月11日

[!警告] [examples/]ディレクトリには、意図的に悪意のあるサンプルを生成したような、テスト目的のためにサンプルSKILLが含まれています。 スキャンテスト環境の外側にこれらのSKILLをインストールまたはロードしないでください。

##特徴

-Pluginベースの静的スキャン — ルールは決定的なセキュリティリスクをキャッチします。

• LLMの断続 — すべてのプラグインのヒットは、LMによって実際のファイルコンテンツに対して再審査されるので、高リコールルールは最終的なレポートを捨てません。
• 行動分析エージェント — 読み取り専用仮想ファイルシステムの内部で、完全なチェーン「指示→ツールコール→ホストの影響」を追跡して、ルールが見逃すリスクを明らかにします。 偽装されたコマンド、Base64ペイロード、リモートコードの読み込み、プロンプト注入、クレデンシャル窃盗、永続など。 -Defen-in-depth sandbox — エージェントは、スキルの内側にのみ読み込まれ、symplinksは拒否され、すべての書き込みはバックエンドで拒否され、ミュートツールはモデルから隠されています.

Vetix

An LLM-agent-based scanner for SKILL directories. Vetix pairs deterministic plugin rules with an LLM behavioral analyst so that both obvious indicators of compromise and subtle, obfuscated attack chains get caught in a single pass.

中文文档

[!WARNING] The examples/ directory contains sample SKILLs for testing purposes, including deliberately crafted malicious samples. Do not install or load these SKILLs outside of a scanning test environment.

Features

• Plugin-based static scanning — rules catch deterministic security risks.
• LLM cross-validation — every plugin hit is re-judged against the real file content by an LLM, so high-recall rules don’t drown the final report.
• Behavioral analysis agent — inside a read-only virtual filesystem, traces the full chain “instruction → tool call → host impact” to uncover risks the rules miss: disguised commands, Base64 payloads, remote code loading, prompt injection, credential theft, persistence, and more.
• Defense-in-depth sandbox — the agent reads only inside the skill, symlinks are refused, every write is rejected at the backend, and mutating tools are hidden from the model.
• Token usage accounting — the report records the token usage of every model call in a scan (prompt / completion / total + call count), so batch scan costs can be estimated.
• LangSmith tracing — every agent run is observable end-to-end.

CLI Options

Usage:
  vetix -s  | -p  [flags]

Flags:
  INPUT
    -s, -source string   SKILL directory path or a skills parent directory
    -p, -preset string   Scan all skills under a preset agent skills root (claude-code, codex)

  CONFIG
    -c, -config string   Path to the YAML config file (default "./config.yaml")
    -l, -language string Output language for audit findings (en, zh) (default "en")

  OUTPUT
    -o, -output          Save the audit report to //report.json (default true)
    -no-output           Disable saving the audit report to a JSON file
    -output-dir string   Base directory for saved reports (default "./output")
    -force               Ignore the cached report and force a full re-scan

  DEBUG
    -d, -debug           Enable debug logging

  PLUGIN
    -pl, -plugins-list   List built-in plugins with their names and descriptions

Common commands

# Scan a single SKILL; requires a SKILL.md file in the directory
vetix -s ./examples/malicious/wacli-1sk

# Scan the entire SKILL directory; requires a SKILL.md file in the immediate subdirectories
vetix -s ~/.claude/skills

# Scan using the preset path
vetix -p claude-code

# View the list of plugins
vetix -pl

Report Caching