cisco-ai-defense/skill-scanner

これは何？

主な機能

• 01YAMLとYARA-Xのパターンルールに、AST・データフロー解析を組み合わせます。
• 02複数のプロバイダーから選べる、検出結果を意味的にレビューするオプションのLLM judgeを備えています。
• 03JSON、Markdown、SARIF、インタラクティブなHTMLレポートを出力します。
• 04再利用可能なGitHub Actionsワークフローとpre-commit hookを提供します。
• 05ポリシープリセットとカスタムYAMLポリシーで、誤検出の量を調整できます。

ユースケース

• コーディングアシスタントにインストールする前に、サードパーティ製のエージェントSkillを審査する。
• SARIFの結果をGitHub Code Scanningに表示し、CIでSkillの変更をチェックする。
• pre-commitを使い、コミットのたびにチームのSkillリポジトリをスキャンする。
• Skill間の重複チェックを行いながら、Skillのディレクトリを一括監査する。

クイックスタート

1. 1

   uvでスキャナーをインストールする

   uv pip install cisco-ai-skill-scanner
2. 2

   LLM judgeのAPIキーを設定する

   export SKILL_SCANNER_LLM_API_KEY="your_api_key"
3. 3

   LLM judgeとbalancedプリセットを使ってskillをスキャンする

   skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

使う前に知っておきたいこと

• !検出はベストエフォートです。検出結果がない場合でも、skillの安全性が保証されるわけではありません。
• !推奨セットアップにはLLM judgeのAPIキーが必要です。ルールだけでは、検証用データに含まれる悪意のあるskillの約8%しか検出できないためです。
• !メタデータではライセンスがNOASSERTIONと記載されています。使用前にライセンス条件を確認してください。

収録されている特集

トピック

よくある質問

skill-scanner とは？

AI Agent Skillsのプロンプトインジェクション、データ窃取、悪意あるコードのパターンを検出するベストエフォート型セキュリティスキャナーです。 Skill Scannerは、AIエージェントのSkillをインストールまたは共有する前に、リスクのある内容がないか確認します。パターンベースの検出に加え、YAMLとYARA-Xのルール、PythonコードのAST・データフロー解析、検出結果を意味的にレビューするオプションのLLM judgeを組み合わせています。結果はJSON、Markdown、SARIF、またはインタラクティブなHTMLレポートで出力できます。

skill-scanner は無料で使えますか？ライセンスは？

skill-scanner は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

skill-scanner は今もメンテナンスされていますか？

活発にメンテナンス中。skill-scanner の最終コミットは 2026年11月6日 です。

skill-scanner は何に使えますか？

コーディングアシスタントにインストールする前に、サードパーティ製のエージェントSkillを審査する。 SARIFの結果をGitHub Code Scanningに表示し、CIでSkillの変更をチェックする。 pre-commitを使い、コミットのたびにチームのSkillリポジトリをスキャンする。 Skill間の重複チェックを行いながら、Skillのディレクトリを一括監査する。

skill-scanner のインストール方法は？

uvでスキャナーをインストールする: uv pip install cisco-ai-skill-scanner LLM judgeのAPIキーを設定する: export SKILL_SCANNER_LLM_API_KEY="your_api_key" LLM judgeとbalancedプリセットを使ってskillをスキャンする: skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

skill-scanner はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/cisco-ai-defense/skill-scanner