Communitygithub.com

coroboros/skillward

信頼できないエージェントスキルをインストール前に分析します。完全な決定論的スキャナー群をオフラインで統合し、一つの判定を下します。

skillward とは?

skillwardは、AIエージェント(Claude Code、Cursor、Codexなど)で使用するスキルをインストールする前に、その安全性を検証するためのツールです。フォルダ、スキルディレクトリ、またはGitリポジトリのURLを指定すると、複数の静的解析スキャナー(skillspector、semgrepなど)をオフラインで実行し、その結果を統合して最終的な「合格/不合格」の判定を生成します。このスキルは、CLIツールが生成したJSONレポートを読み解き、人間やAIが理解しやすい形でリスク評価とアクション(インストール推奨/不推奨/修正後再インストール)を提供します。インストールにはcargo binstall、Homebrew、npxが利用可能で、初回のみDockerを使用したスキャナーバンドルのダウンロードが必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add coroboros/skillward

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

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

ドキュメント

skillward は何をしますか?

信頼できないエージェントスキルを精査します — 1つのフォルダ、スキルディレクトリ、またはリモートの https Git URLを対象に、完全な決定論的スキャナー群をオフラインで実行し、 その結果を統合して1つの判定を下します。CLIが検出を担当し、このスキルは 唯一のインテリジェントなステップ、すなわちレポートを読んでその意味を説明することを追加します。

インストール

CLIがエンジンです。以下のコマンドで一度インストールしてください:

cargo binstall skillward     # プリビルドバイナリ
brew install coroboros/tap/skillward
npx @coroboros/skillward     # Nodeツールチェーン

その後、スキャナーバンドルを取得します(1回限り、Dockerが必要です):

skillward install

skillwardがPATHにない場合は、インストールを中断し、上記のいずれかのコマンドでインストールするようユーザーに伝えてください — スキャンを独自に実装しないでください。手作業のチェックではスキャナー群の検出を逃すため、誤った安全宣言を報告することになります。

使用方法

skillward --helpで全機能を確認できます。デフォルトのスキャンはJSONレポートを出力し、トリアージに利用します:

skillward <target> --format json -o report.json

<target>は、スキルフォルダ、スキルディレクトリ、またはhttps:// GitリポジトリのURLです。終了コード20は、発見結果が--fail-onしきい値(デフォルトはhigh)に達したことを意味します。0はクリーンまたはしきい値未満です。

分析

スキャン後、report.jsonを読み込み、トリアージを生成します — 発見結果をそのまま再表示するのではありません:

  1. 判定を最初に提示する。 PASS または FAIL、最悪の深刻度、および発見結果が複数のツールで裏付けられているかどうか(複数ツールの一致は高信頼性)。
  2. 主要な発見結果の実際のリスクを平易な言葉で説明する — 攻撃者が何を得るのか、具体的なファイルとルールを引用して(例:「呼び出しごとにAWS認証情報を流出させる — setup.sh:7、skillspectorとsemgrepで検出」)。
  3. tool_errorsに注意する — スキャナーが実行されなかった場合、その情報は不完全です。そのことを明示し、全面的な安全宣言を暗示しないでください。
  4. 判断を下す: インストール、インストールしない、または修正後に再インストール。修正が必要な場合は、具体的な変更内容を指定します。

簡潔かつ判断重視に保ちます。発見結果はレポートにあり、判断が仕事です。

関連スキル