Static security scanner for AI agent skill packages. Detects malicious SKILL.md files and bundled scripts before they run.
SkillsGuard があなたのパイプラインを保護しているなら、継続的な研究と新しい検出ルールの開発へのご支援をご検討ください。
ETH 寄付ウォレット
0x11282eE5726B3370c8B480e321b3B2aA13686582
QR コードをスキャンするか、上記のウォレットアドレスをコピーしてください。
AI エージェントのスキルパッケージ向け静的セキュリティスキャナー。 悪意のある SKILL.md ファイルや同梱スクリプトを実行前に検出します。
# Scan any SKILL.md with a single curl — no account, no key
curl -s --data-binary @SKILL.md \
https://skillsguard.apiskillsguard.workers.dev/scan | jq .
注意: SkillsGuard は現在 npm レジストリに公開されていません。ソースをクローンしてビルドすることでインストールしてください。
# 1. Clone, install, build, and link
git clone https://github.com/Teycir/SkillsGuard.git
cd SkillsGuard
npm install
npm run build
npm link
# 2. Scan any skill directory or file
skillsguard /path/to/skill
以上です。SkillsGuard は色分けされた検出結果をターミナルに出力します(CI 用には --json)。
終了コード 0 = クリーン · 1 = 検出あり · 2 = 使用エラー。
エージェントワークフロー内で Claude にスキャナーを自動的に呼び出させたいですか?完全なスキル + MCP のセットアップについては ローカルワークフロー → パス B を参照してください。
flowchart TD
A([Folder, file, or Git diff target]) --> B[Load config\nskillsguard.config.json]
B --> C[File discovery\nFilter JS, PY, PS1, Docker, Ruby...]
C --> D{For each file}
D --> E[Raw text scan\nApply 100+ rules]
D --> F[decode.ts\nExtract encoded blobs]
F --> G[Recursive decode\nbase64, hex, URL]
G --> H[Scan decoded content]
E & H --> I{Findings?}
I -->|no| J([✅ Clean — exit 0])
I -->|yes| K[Deduplicate findings]
K --> L[Compute Risk Score\n0 - 100]
L --> M{Output mode}
M -->|CLI| N[ANSI colored report]
M -->|--json| O[JSON output]
M -->|--sarif| P[SARIF output]
M -->|MCP| Q[MCP response]
N & O & P & Q --> R{Risk > max-risk?}
R -->|yes| S([❌ Exit 1])
R -->|no| J
style A fill:#0d1117,stroke:#00ff88,color:#c3f5dc
style J fill:#0d1117,stroke:#00ff88,color:#00ff88
style S fill:#0d1117,stroke:#ff4444,color:#ff8888
style G fill:#0d1117,stroke:#f0a500,color:#f0c060
style K fill:#0d1117,stroke:#00ff88,color:#c3f5dc
重要なポイント: SkillsGuard は難読化されたペイロードをスキャン前にデコードするため、base64 でラップされたリバースシェルもすり抜けられません。すべての検出結果は重複排除されます — 各ルールはファイルごと、行ごとに最大1回だけ発火します。
エージェントスキルのセキュリティ分野は 2026 年に急速に拡大しました — NVIDIA、Cisco、Snyk、Mondoo はいずれもこの問題に特化したスキャナーをリリースしています。ツールを選ぶ前に、このツールを含めて分野全体を知っておく価値があります。
| ツール | 支援元 | アカウント/トークンが必要 | コアスキャンに LLM 呼び出しが必要 | 検出アプローチ | 特筆すべき追加機能 |
|---|---|---|---|---|---|
| SkillsGuard | 独立系、MIT | 不要 | 不要 | 静的 regex、デコード優先(再帰的な base64/hex/URL/Unicode 展開) | pre-commit フック + git-diff モード、無料 curl API |
| NVIDIA SkillSpector | NVIDIA、Apache 2.0 | 不要 | 不要(セマンティック段階では任意) | 静的 + 任意の LLM セマンティックパス | OSV.dev による依存関係 CVE のライブ検索 |
| Cisco AI Defense Skill Scanner | Cisco | 不要 | 不要(セマンティック段階では任意) | マルチエンジン: 静的 + 振る舞いデータフロー + LLM セマンティック + クラウド | GitHub Actions ワークフロー内蔵 |
| Snyk Agent Scan(旧 mcp-scan) | Snyk、商用 | 必要 — SNYK_TOKEN が必須 | 必要 — 決定論的ルール + LLM 判定の組み合わせ | Claude/Cursor/Windsurf/Gemini CLI + MCP サーバーを自動検出 | Vercel のインストール時スキルスキャンを支える |
| SkillScan | 独立系 | 不要 | predict モードのみ(任意) | YAML ルールエンジン + 任意の LLM 振る舞いドライラン + 任意の Docker サンドボックス | LLM ロールプレイによる時間的/遅延発動の検出 |
| Mondoo Skill Check | Mondoo、商用 | 不要(無料枠、非商用) | 公開ドキュメントからは不明 | 静的、OWASP LLM Top 10 にマッピング | ホスト型ダッシュボード + REST API |
最も重要な共通点: SkillsGuard はこの表の中で、完全なスキャンを実行するのに Node ≥18.3 以外に何も必要としない唯一のツールです — アカウントも、API トークンも、LLM エンドポイントも、ネットワーク呼び出しも不要です。活発にメンテナンスされている他の競合はすべて、サービスへのサインアップを要求する(Snyk)か、完全なカバレッジを得るために LLM プロバイダーの設定を推奨しています(NVIDIA、Cisco、SkillScan)。そのため SkillsGuard は、オフラインで毎回同じように動作する必要がある CI ゲートや pre-commit フックにとって最もシンプルな選択肢であり、セマンティック/意図レベルのレビューを求めて追加の依存関係を気にしない場合には LLM 拡張ツールの方が適しています。
これらは相互排他的ではありません。常識的な構成としては、SkillsGuard(または任意のゼロ依存静的ツール)を高速で決定論的なCI/プリコミットゲートとして使い、本当に新しい、あるいは高権限のスキルを信頼する前のより深い単発レビューにはLLM拡張スキャナーの1つを組み合わせる、というものです。
SkillSpectorはアーキテクチャ上最も類似したプロジェクトです — 同じ「インストール前にスキャン」という枠組み、同じSARIF/JSON出力のストーリーを持ち、公開された実証研究(42,447件のスキルをスキャンし、26.1%が脆弱と判明)に裏付けられています。
| SkillsGuard | NVIDIA SkillSpector | |
|---|---|---|
| 実行時依存 | なし — Node ≥18.3、npm依存ゼロ | Python ≥3.12 |
| 検出アプローチ | 静的regex、デコード優先 | 静的 + オプションのLLMセマンティックパス |
| ルール数 | 151ルール / 15カテゴリ | 64パターン / 16カテゴリ |
| 依存関係のCVE検索 | なし | あり — OSV.devのライブ検索 |
| インストール | npm link または無料ホスト型curl APIによるゼロインストール | pip install / git clone |
| プリコミットフック | あり — install-hook、ベースラインワークフロー付き | 文書化されたワークフローには含まれない |
| Git diff / ステージ済みファイルモード | あり — --diff、--staged | 文書化されたワークフローには含まれない |
| SARIF出力 | あり | あり |
| MCPサーバー | あり — scan_skill、scan_skills_dir、教示可能な SKILL.md | 該当なし(LangGraphベースのパイプライン) |
| 成熟度(執筆時点) | v1.2.0 | v2.0.0、GitHubスター5.5k以上、論文公開済み |
正直な評価: SkillSpectorはより多くの研究的裏付けを持ち、regexでは捉えられない意図レベルの問題を検出するLLMセマンティックステージを備えています — 例えば、コードを整形すると謳いながら密かに ~/.ssh も読み取るスキルなどです。この追加の推論レイヤーが、依存ゼロを保つことよりも重要なら、強い選択肢です。盲目的にどちらかを選ぶのではなく、同じスキルを両方でスキャンして検出結果を比較する価値があります。
AIエージェントのスキルパッケージ(SKILL.md + 同梱スクリプト)は、新しく、ほとんど監査されていない攻撃対象領域です。悪意あるスキルは以下のことが可能です: