メインコンテンツまでスキップ

audit

インストール済みの Skill をスキャンし、セキュリティ上の脅威や悪意のあるパターンを検出します。

skillshare audit                        # インストール済みの全 Skill をスキャン
skillshare audit <name> # 特定のインストール済み Skill をスキャン
skillshare audit a b c # 複数の Skill をスキャン
skillshare audit --group frontend # グループ内の全 Skill をスキャン
skillshare audit <path> # ファイル/ディレクトリのパスをスキャン
skillshare audit --threshold high # HIGH 以上の findings でブロック
skillshare audit -T h # --threshold high と同じ
skillshare audit --format json # JSON 出力
skillshare audit --format sarif # SARIF 2.1.0 出力(GitHub Code Scanning)
skillshare audit --format markdown # Markdown レポート(GitHub Issues/PR 向け)
skillshare audit --json # --format json と同じ(非推奨)
skillshare audit -p # project の Skill をスキャン
skillshare audit --quiet # findings のある Skill のみ表示
skillshare audit --yes # 大規模スキャンの確認をスキップ
skillshare audit --no-tui # プレーンテキスト出力(インタラクティブ TUI なし)
skillshare audit --profile strict # strict プロファイルを使用(HIGH 以上でブロック)
skillshare audit --dedupe global # 完全な composite-key 重複排除
skillshare audit --analyzer static # static analyzer のみ実行
skillshare audit --analyzer static --analyzer dataflow # 複数の analyzer

表示する最低重大度​

skillshare audit --min-severity high
skillshare audit --format markdown --min-severity medium

--min-severity <level> は critical、high、medium、low、info の指定値以上の検出結果を表示します(大文字小文字を区別せず、h などの略称も使用可能)。既定ではすべて表示します。端末(TUI を含む)と Markdown の表・スニペットだけに適用され、すべて非表示でも表示件数と非表示件数を示します。スコア、summary.maxSeverity、ブロック判定、終了コード、スキャンエラー、不完全なスキャンの警告は全結果に基づきます。JSON と SARIF はこのフラグを無視し、追加メタデータなしで完全な出力を維持します。

ダッシュボードでは重大度フィルターを「最低重大度」に切り替え、重大度の件数を選択すると、その値以上を表示します。「指定した重大度のみ」は従来の完全一致選択です。選択中の重大度を再度クリックすると解除されます。未選択時は LOW/INFO の折りたたみを維持し、非表示件数に含めます。フィルターは再スキャンやポリシー、スコア、ブロック状態を変更しません。

承認済みの検出結果​

skillshare audit --respect-accepted
skillshare audit --respect-accepted --threshold high --format json

install や update で --force を使って受け入れた検出結果は .metadata.json に記録されます(Accepted Findings を参照)。通常の audit では、これらは引き続き失敗として扱われます。--respect-accepted を付けると、audit は update の gate と同じようにこれらの承認を適用します。検出結果はレポートに残りますが、失敗の原因にはなりません。ほかの検出結果がしきい値未満のリソースは警告として数えられ、ほかにしきい値に達する検出結果がなければ終了コードは 0 になります。内容が変わった検出結果は、改めて承認が必要です。

承認済みの検出結果は、すべての出力形式で次のように示されます。

形式表示
テキストと TUI検出結果の下に accepted earlier with --force。テキストのサマリーには Accepted 行が追加されます
JSON検出結果に "acknowledged": true。summary.accepted がその件数で、summary.critical などの重大度の件数には含めません
Markdownメッセージの後ろに (accepted earlier)。サマリー表には Accepted 行が追加されます
SARIFkind が external の suppressions エントリ

tracked リポジトリ内の skill も、リポジトリ全体に対して記録された承認と照合されます。例外は bundled の hook と settings の検出結果です。その根拠にはリポジトリ全体のスキャンで見たファイル名が含まれるため、skill 単体の audit では引き続き失敗します。

使うタイミング​

  • 新しい Skill をインストールした後にセキュリティの findings を確認する
  • プロンプトインジェクション、データ流出、認証情報アクセスのパターンについて全 Skill をスキャンする
  • 組織のセキュリティポリシーに合わせて audit ルールをカスタマイズする
  • コンプライアンス向け(--format json)、静的解析ツール向け(--format sarif)、またはドキュメント向け(--format markdown)の audit レポートを生成する
  • CI/CD パイプラインに組み込んで Skill のデプロイをゲートする
  • SARIF の結果を GitHub Code Scanning にアップロードして PR レベルの注釈を行う

検出内容​

audit エンジンは、Skill ディレクトリ内のすべてのテキストベースのファイルを 100 以上の組み込みルール(正規表現パターン、テーブル駆動の認証情報検出、構造チェック、コンテンツの整合性検証、サプライチェーンの信頼性分析)と照合し、5 段階の重大度(CRITICAL、HIGH、MEDIUM、LOW、INFO)に分類します。

Markdown のサンプルもスキャンされます。解析されたフェンス付きコードブロック内で、パラメータ形式の SDK system: / System: 値(prompt-injection-1)は HIGH として報告されます。Markdown 以外のソースファイルでは、prompt-injection-1 は ROOT: のような大文字ラベルにのみ一致します。「Do not tell the user they need to adopt an eval framework」のような一般的な開示制限は、すべてのファイル形式で HIGH の prompt-injection-5 に一致します。明示的な隠蔽は prompt-injection-4 の CRITICAL を維持します。.py ファイルでは、コメントだけの行と docstring での組み込み CRITICAL credential-access マッチは HIGH として報告されます(認証情報アクセスを参照)。HIGH は既定の CRITICAL しきい値では警告、strict ではブロックとなります。制限とルール上書きの互換性は Prompt Injection を参照してください。

完全な検出カタログ、脅威カテゴリの詳細、リスクスコアリングアルゴリズム、コマンド安全性のティア分類、Skill 間の相互作用分析については、Audit Engine を参照してください。

出力例​

skillshare audit
Audit ~/.config/skillshare/skills
global · blocks at CRITICAL · policy DEFAULT / dedupe:GLOBAL / analyzers:ALL

! ci-release-helper HIGH · risk 25/100
✗ suspicious-skill CRITICAL · risk 35/100

Summary
Scanned 12 skills
✓ Passed 9
! Warning 2
✗ Failed 1
Severity 1 critical, 2 high, 1 medium
Threats credential:1 exfiltration:1 injection:1 privilege:1
Risk HIGH 35/100 · 100% auditable

✗ Blocked 1 of 12 skills: findings at CRITICAL or above · 2.1s
The risk score is informational; only the severity blocks

Next
skillshare audit suspicious-skill see its findings

Failed は、有効な閾値(--threshold または config の audit.block_threshold、デフォルトは CRITICAL)以上の findings を持つ Skill の数を数えます。

Threats は、短縮名を使ってすべての findings をカテゴリ別に内訳表示します: inj(injection)、exfil(exfiltration)、cred(credential)、obfusc(obfuscation)、priv(privilege)、integ(integrity)、struct(structure)、risk(risk)。findings がない場合、この行は省略されます。ターミナル出力では、各カテゴリは脅威タイプごとに色分けされます。

audit.block_threshold はブロックの閾値のみを制御します。スキャン自体を無効化することはありません。

インタラクティブ TUI モード​

インタラクティブなターミナルで複数の Skill をスキャンすると、audit は結果を 1 行ずつ出力する代わりにフルスクリーンの画面を開きます。左側に Skill(問題のあるものが先頭)、右側に選択した Skill のリスク概要と検出結果が表示されます。Skill を開くと、検出結果ごとにそのファイルの該当行が行番号付きでハイライト表示されます。キーは画面下部に表示されます。

この画面が開くのは、ターミナルがインタラクティブで、出力が JSON ではなく、結果が複数ある場合だけです。プレーンテキストを強制するには --no-tui を使用します。

大規模スキャンの確認​

インタラクティブなターミナルで 1,000 を超える Skill をスキャンする場合、コマンドは実行前に確認を求めます。TTY 環境(例: ローカルの自動化スクリプト)でこのプロンプトをスキップするには --yes を使用します。CI/CD パイプライン(非 TTY)では、このプロンプトは自動的にスキップされます。

ポリシーとプロファイル​

audit コマンドは、プロファイル、重複排除モード、analyzer の選択を通じたポリシー駆動の設定をサポートします。これらは CLI フラグ、project config、またはグローバル config で設定できます。

プロファイル​

プロファイルは、閾値と重複排除の適切なデフォルトを設定するプリセットです。

プロファイル閾値重複排除用途
defaultCRITICALglobal標準的な動作 — critical な脅威のみをブロック
strictHIGHglobalセキュリティ重視のチーム — high 以上の脅威をブロック
permissiveCRITICALlegacyアドバイザリ専用 — 最小限のブロック、グローバル重複排除なし
skillshare audit --profile strict       # HIGH 以上でブロック、グローバル重複排除
skillshare audit --profile permissive # アドバイザリモード

明示的なフラグは常にプロファイルのデフォルトより優先されます。

skillshare audit --profile strict --threshold medium  # strict プロファイルだが MEDIUM 以上でブロック

重複排除​

同じ finding が複数の analyzer(例: static と dataflow の両方)で検出された場合、重複排除は冗長なエントリを削除します。

モード動作
globalすべての findings に対する完全な composite-key 重複排除(デフォルト)
legacyanalyzer 単位のみの重複排除(v0.16.9 以前の動作)

Analyzer の選択​

デフォルトではすべての analyzer が実行されます。特定の analyzer のみを実行するには --analyzer を使用します。

skillshare audit --analyzer static                    # static パターンマッチングのみ
skillshare audit --analyzer static --analyzer dataflow # 複数の analyzer
Analyzerスコープ説明
staticファイル単位正規表現パターン照合とファイル単位の空白埋め込み検査
dataflowファイル単位shell スクリプトと markdown コードブロックの taint tracking
tierSkill 単位Capability tier の組み合わせリスク分析
integritySkill 単位コンテンツハッシュ検証(SKILL.md の file_hashes)
metadataSkill 単位サプライチェーンの信頼性検証(publisher の不一致、権威の主張)
structureSkill 単位ローカル Markdown リンク/画像と明示されたバンドル内パスの欠落、ルート外参照を検出; 同梱フックと設定
cross-skillバンドル単位Skill 間のデータ流出・権限昇格分析

config で設定することもできます。

audit:
enabled_analyzers: [static, dataflow]

優先順位​

設定は次の順序で解決されます(最初に空でない値が優先されます)。

  1. CLI フラグ(--profile, --threshold, --dedupe, --analyzer)
  2. Project config(.skillshare/config.yaml)
  3. グローバル config(~/.config/skillshare/config.yaml)
  4. プロファイルのデフォルト

自動スキャン​

インストール時​

Skill はインストール中に自動的にスキャンされます。audit.block_threshold(デフォルト: CRITICAL)以上の findings があるとインストールがブロックされます。

skillshare install /path/to/evil-skill
# Error: security audit failed: critical threats detected in skill

skillshare install /path/to/evil-skill --force
# 警告付きでインストールする(注意して使用)

skillshare install /path/to/skill --audit-threshold high
# コマンド単位のブロック閾値の上書き

skillshare install /path/to/skill -T h
# --audit-threshold high と同じ

skillshare install /path/to/skill --skip-audit
# スキャンをバイパスする(注意して使用)

--force は検出結果によるブロックの判定を上書きします。スキャンを実行できない場合はブロックされたままです。--skip-audit は、そのインストールコマンドに対するスキャンを無効化します。

install 時の audit をグローバルに無効化する config フラグはありません。意図的にスキャンをバイパスしたいコマンドに限って --skip-audit を使用してください。

差異のまとめ:

Install フラグAudit は実行される?Findings は利用可能?
--forceはいはい(インストールは続行される)
--skip-auditいいえいいえ(スキャンはバイパスされる)

両方が指定された場合、audit が実行されないため実質的に --skip-audit が優先されます。

更新時​

skillshare update は追跡中のリポジトリを隔離された候補に pull し、公開前に監査します。有効な閾値(デフォルトは audit.block_threshold、または --audit-threshold / --threshold / -T による上書き)以上の findings は、明示的に受け入れない限り公開をブロックします。拒否時は実際のチェックアウトを変更しません。詳細は update --skip-audit を参照してください。

--force で受け入れた findings はその Skill について記憶されます。承認キーは行番号を無視し、rule、ファイル、一致したテキスト、および検出器固有の証拠を含みます。whitespace-padding では、パディングされた内容が変わると新しいキーになり、密度 finding はファイル内の対象コンテンツ全体を証拠として使います。詳しくは Accepted Findings を参照してください。

install 経由で追跡中のリポジトリを更新する場合(skillshare install <repo> --track --update)、ゲートは同じ閾値ポリシー(audit.block_threshold または --audit-threshold / --threshold / -T)を使用します。

CI/CD 統合​

audit コマンドはパイプライン自動化向けに設計されています。非 TTY 環境(CI ランナー、パイプ出力)では、インタラクティブ TUI と確認プロンプトは自動的に無効化されます — --yes や --no-tui は不要です。

完全な CI/CD ワークフロー(GitHub Actions、GitLab CI、SARIF アップロード、出力フォーマット)については、CI/CD Skill Validation recipe を参照してください。

Pre-commit フック​

pre-commit フレームワークを使って、コミットごとに skillshare audit を自動実行します。このフックは .skillshare/ または skills/ ディレクトリに一致するファイルをスキャンし、findings が設定した閾値を超える場合にコミットをブロックします。

# .pre-commit-config.yaml
repos:
- repo: https://github.com/runkids/skillshare
rev: v0.16.11 # 最新のリリースタグを使用
hooks:
- id: skillshare-audit

完全なセットアップ手順は Pre-commit Hook recipe を参照してください。

ベストプラクティス​

個人開発者向け​

  • 信頼する前に audit する — 信頼できないソースから Skill をインストールした後は、必ず skillshare audit を実行する
  • 合否だけでなく findings を確認する — 「合格」した Skill でも、調査する価値のある LOW/MEDIUM の findings がある場合がある
  • Skill ファイルを読む — 自動スキャンは既知のパターンを検出するが、新種の攻撃には人間によるレビューが必要

チームおよび組織向け​

  • audit.block_threshold: HIGH を設定する — デフォルトの CRITICAL より厳しくし、難読化や破壊的なコマンドを検出する
  • 組織全体のカスタムルールを作成する — 社内のシークレット形式(例: corp-api-key-*)用のパターンを追加する
  • オーバーライドには project モードのルールを使う — グローバルではなく project 単位で、想定されるパターンの重大度を引き下げる

推奨される Audit ワークフロー​

  1. インストール: Skill は自動的にスキャンされる — 閾値を超えるとブロックされる
  2. 定期スキャン: インストール後に更新されたルールを検出するために、定期的に skillshare audit を実行する
  3. Pre-commit フック: pre-commit フレームワーク でコミット前に問題を検出する
  4. CI ゲート: 共有 Skill リポジトリのために、CI パイプラインに audit を追加する
  5. カスタムルール: 組織の脅威モデルに合わせて検出をカスタマイズする
  6. レポートを確認する: コンプライアンス向けには --format json、GitHub Code Scanning 向けには --format sarif、GitHub Issues/PR 向けには --format markdown を使用する

閾値の設定​

config ファイルでブロック閾値を設定します。

# ~/.config/skillshare/config.yaml
audit:
block_threshold: HIGH # HIGH 以上でブロック(デフォルトの CRITICAL より厳しい)

またはコマンド単位で設定します。

skillshare audit --threshold medium  # MEDIUM 以上でブロック

完全な Audit 設定​

すべての audit 設定は config.yaml に永続化できます。

# ~/.config/skillshare/config.yaml (project の場合は .skillshare/config.yaml)
audit:
block_threshold: HIGH # ブロックの重大度ゲート
profile: strict # プロファイルのプリセット(default/strict/permissive)
dedupe_mode: global # 重複排除モード(global/legacy)
enabled_analyzers: [static, dataflow, tier] # 特定の analyzer に限定

CLI フラグは config の値より優先されます。完全な解決順序については 優先順位 を参照してください。

skillshare status コマンドは、すべての優先順位のレイヤーを適用した後の、有効なプロファイル、閾値、重複排除モード、analyzer リストを表示する、解決済みの audit ポリシーを表示します。

Web UI​

audit 機能は、Web ダッシュボードの /audit でも利用できます。

skillshare ui
# Audit ページに移動 → 「Run Audit」をクリック

Security Audit page in web dashboard

Dashboard ページには、クイックスキャンのサマリーを含む Security Audit セクションがあります。

Audit ページは常に承認済みの検出結果を適用します。以前に --force で承認済みという注記付きで薄く表示し、重大度ではなく 承認済み として数え、ブロック済みには数えません。承認済みを表示 を外すと非表示になります。Skill の Audit タブでは専用の展開ボタンの後ろに折りたたまれ、ダッシュボードの要対応カードでは高リスクの件数に含めません。

カスタムルールエディタ​

Web ダッシュボードには、ブラウザ上で直接カスタムルールを作成・編集するための専用の Audit Rules ページが /audit/rules にあります。

  • 作成: audit-rules.yaml が存在しない場合、「Create Rules File」をクリックしてスキャフォールドする
  • 編集: シンタックスハイライトと検証機能付きの YAML エディタ
  • 保存: 保存前に YAML フォーマットと正規表現パターンを検証する

Audit ページの「Custom Rules」ボタンからアクセスできます。

終了コード​

コード意味
0スキャンエラーがなく、有効な閾値以上の findings もない
1有効な閾値以上の findings が 1 件以上あり、スキャンエラーはない
2スキャン失敗を含む audit の実行、使用方法、設定のエラー

--respect-accepted を付けると、--force で承認済みの検出結果は 1 の判定に数えられません。大規模スキャンの確認で No を選ぶと、スキャンせずに 0 で終了します。list から開始した audit も同じ終了コードを使用します。

スキャンエラーは findings より優先されます。利用可能な場合は部分的な構造化レポートも出力されます。

スキャン対象ファイル​

audit は Skill ディレクトリ内のテキストベースのファイルをスキャンします。

  • .md, .txt, .yaml, .yml, .json, .toml
  • .sh, .bash, .zsh, .fish
  • .py, .js, .ts, .rb, .php, .php3, .php4, .php5, .phtml, .go, .rs, .swift
  • 拡張子のないファイル(例: Makefile, Dockerfile)

テキストスキャンは隠しディレクトリを除き、各 Skill ディレクトリ内で再帰的に行われるため、サポート対象のテキストファイルタイプに一致する限り、SKILL.md、ネストした references/*.md、scripts/*.sh もすべて検査されます。リポジトリ全体のスキャン(install --track や追跡リポジトリの更新時の監査)では、隠しディレクトリをリポジトリ内の各 Skill を基準に判定するため、.agents/skills/ や .curated/ 内の Skill もテキストスキャンの対象になり、.claude/skills/ などのターゲットのコピーはヘッダーのみの検査のままです。

テキストの絞り込み前に、audit は通常ファイルごとに先頭 512 バイトを読み、実行形式、CPython バイトコード、ZIP/JAR、偽装した shebang スクリプトを分類します。Skill 内の隠しディレクトリはヘッダー分類のみで、__pycache__ も対象です。特殊ファイル以外へのリンクは従来のテキスト解析を維持します。特殊ファイルへのリンクはスキップされ、直接監査ではエラーになります。.git、.skillshare、内部・OS メタデータ、リンクと特殊ファイルはヘッダーを読みません。バイナリとサイズ超過ファイルは全文テキスト解析しません。サマリーは binaryFiles、skippedFiles、oversizedFiles を報告し、これらは重複して数えられます。実行動作とアーカイブ内部は解析しません。形式・重大度・上限は実行形式とアーカイブのヘッダーを参照してください。 PE ヘッダーが範囲外の場合は、その位置から必要なバイト数だけ追加で読み取ります。 structure アナライザーは 同梱フックと設定 のために skill 内の .claude/settings.json と .claude/settings.local.json も読み取ります。

オプション​

フラグ説明
-G, --group <name>グループ内のすべての Skill をスキャン(複数指定可)
-p, --projectproject レベルの Skill をスキャン
-g, --globalグローバルな Skill をスキャン
--threshold <t>, -T <t>ブロック閾値: critical|high|medium|low|info(省略形: c|h|m|l|i、加えて crit, med)
--min-severity <level>指定した重大度以上を表示。スコア・判定・機械可読出力は変更しません
--profile <p>Audit プロファイルのプリセット: default, strict, permissive
--dedupe <mode>重複排除モード: legacy, global(デフォルト)
--analyzer <id>指定した analyzer のみ実行(複数指定可)。ID: static, dataflow, tier, integrity, metadata, structure, cross-skill
--format <f>出力フォーマット: text(デフォルト), json, sarif, markdown。たどられた source リンクを読み取れなかった場合、JSON には warnings と incomplete: true が追加され、部分的なスキャンが完全なスキャンと誤認されないようになります。Markdown ではそのリンクを Source links not followed に列挙し、TUI のサマリー行にはその件数が表示されます
--jsonJSON を出力(非推奨: --format json を使用)
--yes, -y大規模スキャンの確認プロンプトをスキップ(自動確認)
--quiet, -qfindings のある Skill とサマリーのみ表示(クリーンな ✓ 行を抑制)
--no-tuiインタラクティブ TUI を無効化し、プレーンテキストを出力
--respect-accepted--force で承認済みの検出結果では失敗しない。承認済みとして表示されます。承認済みの検出結果 を参照
--init-rulesスターター用の audit-rules.yaml を作成(-p/-g に対応)
-h, --helpヘルプを表示

サブコマンド​

サブコマンド説明
rulesaudit ルールの閲覧、有効化、無効化(audit rules を参照)

Agent サポート​

skillshare audit agents はセキュリティスキャンの対象を agent のみに絞り、agent の source ディレクトリ内の .md ファイルをスキャンします。

skillshare audit agents                    # すべての agent をスキャン
skillshare audit agents --threshold high # agent の HIGH 以上でブロック
skillshare audit agents --format sarif # agent 向けの SARIF 出力
skillshare audit agents -p # project の agent をスキャン

Agent は、Skill と同じ audit ルール、重大度レベル、閾値ゲートの対象になります。agents 引数を指定しない場合、audit は Skill のみをスキャンします(デフォルトの動作)。背景については Agents を参照してください。

関連項目​

  • Audit Engine — エンジンの仕組み(脅威モデル、リスクスコアリング、コマンドのティア分類)
  • audit rules — ルールの管理とカスタマイズ
  • install — Skill をインストール(自動スキャン付き)
  • check — Skill の整合性と同期状態を検証
  • doctor — セットアップの問題を診断
  • list — インストール済みの Skill を一覧表示
  • Securing Your Skills — チームや組織向けのセキュリティガイド
  • CI/CD Skill Validation — パイプライン自動化のレシピ
  • Pre-commit Hook — コミットごとの自動 audit
  • Agents — Agent の概念