SkillsGuard は何をしますか?
AIエージェントのスキルパッケージ用静的セキュリティスキャナー。実行前に悪意のあるSKILL.mdファイルやバンドルされたスクリプトを検出します。
概要
このツールは、AIエージェント(Claude Code、Cursor、Codexなど)で使用されるスキルパッケージを解析し、セキュリティ上の脅威を特定します。スキルが実行される前に、SKILL.mdファイルや関連スクリプトに含まれる悪意のあるコードパターンをスキャンします。
機能
SKILL.mdファイル内の埋め込みスクリプトやコマンドの静的解析- バンドルされたスクリプト(シェルスクリプト、Pythonなど)の危険なパターンの検出
- 環境変数や機密情報の漏洩の可能性をチェック
- ファイルパスやコマンド実行に関する不審な操作を特定
使用方法
# スキルパッケージディレクトリをスキャン
tecyir-skillsguard scan ./my-skill-package
例:特定のスキルパッケージを安全に評価
tecyir-skillsguard scan /path/to/skill-directory --format json
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIエージェント向けスキルパッケージ
詳細
このセキュリティスキャナーは、スキルパッケージ内の以下の要素を検査します:
- SKILL.md:マークダウンファイル内のコードブロックやインラインコード、悪意のあるリンク、スクリプト注入の可能性を解析
- バンドルスクリプト:シェルスクリプト(
.sh)、Pythonスクリプト(.py)、その他の実行可能ファイルに含まれる危険なコマンド(例:rm -rf、wget|curlによるダウンロードと実行、機密情報の外部送信など) - 設定ファイル:
.env、config.jsonなどのファイルに漏洩したシークレットキーやトークン
インストール
npm install -g teycir-skillsguard
または
go install github.com/teycir/skillsguard@latest
例:スキャン結果
$ teycir-skillsguard scan ./sample-skill
スキャン結果:
- SKILL.md: 悪意のあるコードブロックを検出 (重大度: 高)
- scripts/deploy.sh: 機密情報の漏洩の可能性 (重大度: 中)
- config.json: 外部サーバーへの接続を試みる不審なURLを検出 (重大度: 低)
セキュリティ警告: 2件
推奨: スキルを実行する前に上記の問題を確認・修正してください。
注意事項
- このツールは静的解析に基づくため、すべての脅威を検出できるとは限りません。動的解析と組み合わせて使用することを推奨します。
- 信頼できないソースからのスキルパッケージは、必ず事前にスキャンしてください。
- CI/CDパイプラインに組み込むことで、継続的なセキュリティチェックが可能です。
ライセンス
MIT