charliichenye/SkillGate

SkillGate は何をしますか？

AIエージェントスキルとMCP設定に対するマージ前・インストール前の信頼チェック。CIで機能をスキャンし、リスクのある変更を検出し、未承認のエージェント行動をブロックします。

概要

SkillGateは、AIエージェント（Claude Code、Cursor、Codexなど）用のスキルやMCP（Model Context Protocol）設定が、チームや組織のセキュリティポリシーに準拠しているかを自動的に検証するためのCIツールです。スキルのマニフェストファイルや設定ファイルを解析し、宣言された機能（ファイル読み書き、ネットワークアクセス、コマンド実行など）を一覧化します。その後、許可リストとブロックリストに基づいてリスク評価を行い、危険な変更が含まれている場合はマージやインストールをブロックします。

ユースケース

• CIでのセキュリティゲート: GitHub Actionsなどに組み込み、PRのマージ前にスキル変更の安全性を自動チェック。
• スキル開発のガバナンス: 開発者が作成したスキルが組織のポリシーに従っているかを事前に確認。
• MCP設定の監査: 外部サービスとの連携設定が適切か、過剰な権限がないかを検証。

インストール

# npm を使用する場合
npm install -g @skillgate/cli

# yarn を使用する場合
yarn global add @skillgate/cli

使い方

CLI コマンド

skillgate scan <path-to-skill-or-config>

CI パイプラインへの統合例 (GitHub Actions)

name: Skill Security Check

on:
  pull_request:
    paths:
      - '**/*.skill.md'
      - '**/mcp.json'

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run SkillGate
        run: skillgate scan .

設定

プロジェクトルートに skillgate.config.json または skillgate.config.yaml を作成します。

設定例 (JSON)

{
  "allowlist": [
    {
      "name": "安全なスキル",
      "capabilities": ["read_files", "write_files"]
    }
  ],
  "blocklist": [
    {
      "name": "危険なスキル",
      "capabilities": ["network_access", "execute_commands"]
    }
  ],
  "severity": "high"
}

機能

• スキルマニフェストの自動解析 (SKILL.md 形式対応)
• MCP設定ファイルのスキャン (mcp.json, mcp.yaml)
• 許可・ブロックリストによる柔軟なルール設定
• CIツールとの統合 (GitHub Actions, GitLab CI, Jenkins)
• 詳細なレポート出力 (JSON, SARIF)

依存関係

• Node.js 16 以上
• スキルファイルの解析には js-yaml と marked を使用

セキュリティに関する注意

SkillGateはシグナルを提供しますが、最終的な判断は人間が行う必要があります。誤検出の可能性に注意し、設定を適宜調整してください。また、スキル自体が悪意のあるコードを含んでいないかは別途レビューが必要です。

ライセンス

MIT