Communityコーディング&開発github.com

Teycir/SkillsGuard

AIエージェントのスキルパッケージ用静的セキュリティスキャナー。実行前に悪意のあるSKILL.mdファイルやバンドルされたスクリプトを検出します。

SkillsGuard とは?

Teycir/SkillsGuardは、Claude Code、Cursor、CodexなどのAIエージェントで使用するスキルパッケージ(SKILL.mdファイルやバンドルスクリプト)に潜むセキュリティリスクを事前に検出する静的解析ツールです。スキルを実行環境に読み込む前に、悪意のあるコードや不審なパターンをスキャンし、開発者やユーザーを保護します。このツールは主にCLIツールとして動作し、指定されたディレクトリ内のSKILL.mdやスクリプトファイルを解析して、潜在的に危険な動作(例:環境変数の漏洩、不正なファイル操作、コマンドインジェクションなど)を報告します。これにより、サードパーティ製のスキルを安全に利用したり、自作スキルのセキュリティ品質をチェックしたりすることが可能になります。対応プラットフォームとしては、Claude CodeやCursorなどの主要なAIエージェントを想定しており、CI/CDパイプラインに組み込んで自動チェックを行うこともできます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add Teycir/SkillsGuard

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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エージェント向けスキルパッケージ

詳細

このセキュリティスキャナーは、スキルパッケージ内の以下の要素を検査します:

  1. SKILL.md:マークダウンファイル内のコードブロックやインラインコード、悪意のあるリンク、スクリプト注入の可能性を解析
  2. バンドルスクリプト:シェルスクリプト(.sh)、Pythonスクリプト(.py)、その他の実行可能ファイルに含まれる危険なコマンド(例:rm -rf、wget|curlによるダウンロードと実行、機密情報の外部送信など)
  3. 設定ファイル:.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

関連スキル