analyze

各 Target の Skill について、コンテキストウィンドウの使用量と Skill の品質を分析します。

skillshare analyze                    # インタラクティブ TUI（デフォルト）
skillshare analyze claude             # 単一 Target の詳細
skillshare analyze --verbose          # 説明文が最も長い上位 10 件
skillshare analyze --json             # 機械可読な出力
skillshare analyze -p                 # Project mode

使うタイミング

コンテキスト予算を最適化する

どの Skill がコンテキストウィンドウのトークンを最も消費しているかを特定する。

skillshare analyze           # すべての Target をインタラクティブに閲覧

Target 間で比較する

Target 間（例: Claude と Cursor）でコンテキスト使用量がどう違うかを確認する。

skillshare analyze           # TUI 内で Tab キーを押して Target を切り替え

Skill の品質を確認する

フィールドの欠落、説明文の短さ、トリガーフレーズの欠如がある Skill を見つける。

skillshare analyze           # TUI 内に Lint アイコン（✗/⚠）が表示される

CI/スクリプト

機械可読なコンテキストメトリクスと Lint 結果を取得する。

skillshare analyze --json | jq '.targets[].always_loaded.estimated_tokens'
skillshare analyze --json | jq '.targets[].skills[] | select(.lint_issues | length > 0)'

実行内容

analyze は各 Skill について、2 層のコンテキストコストを計算します。

常時ロード — SKILL.md のフロントマターにある name + description（Skill マッチングのため、すべてのリクエストでコンテキストにロードされる）
オンデマンド — フロントマター以降の Skill 本文（Skill がトリガーされたときのみロードされる）

トークン数の見積もりには近似値として chars / 4 を使用します。

Skill 品質 Lint

トークン分析に加えて、analyze はすべての Skill に対して組み込みの Lint エンジンを実行します。Lint ルールは SKILL.md の構造と説明文の品質をチェックし、問題を TUI と JSON 出力に直接表示します。

ルール	重大度	チェック内容
`missing-name`	error	`name` フィールドが空または欠落している
`missing-description`	error	`description` フィールドが空または欠落している
`empty-body`	error	Skill 本文（フロントマター以降）が空である
`description-too-short`	warning	説明文が 50 文字未満
`description-too-long`	warning	説明文が目標上限の 1024 文字を超えている
`description-near-limit`	warning	説明文が 900〜1024 文字の範囲にある
`no-trigger-phrase`	warning	説明文にトリガーフレーズ（例: "Use when…"）がない

TUI では、Lint 上の問題がある Skill は名前の横に ✗（error）または ⚠（warning）アイコンが表示されます。詳細パネルには、すべての検出結果を一覧する Quality セクションが含まれます。

インタラクティブ TUI

TTY 上では、analyze はターゲットごとにインタラクティブな画面を開きます。左側にトークン量順の Skill、右側に選択した Skill のトークン内訳、lint の問題、説明が表示されます。Skill を開くと、front matter を含むファイルの原文が表示され、lint の問題と照らし合わせられます。キーは画面下部に表示されます。プレーンテキストにするには --no-tui を使用します。

色分け

トークン消費量のレベルは、Target ごとに動的なパーセンタイル閾値を使用します。

色	意味
🔴 赤	P75 以上（消費量上位 25%）
🟡 黄	P25〜P75（中間 50%）
🟢 緑	P25 未満（下位 25%）

出力例

デフォルト（--no-tui）

claude · 7 skills
  Always loaded  ~362 tokens
  On-demand max  ~22 tokens

  Add -v for the 10 largest descriptions

詳細

skillshare analyze --verbose

claude · 7 skills
  Always loaded  ~362 tokens
  On-demand max  ~22 tokens

  Largest descriptions
    my-big-skill   ~180 tokens
    another-skill  ~120 tokens
    …

単一 Target

Target 名を渡すと、自動的に verbose 出力が有効になります。

skillshare analyze claude

グループでフィルタする

# frontend 系のすべての Skill の合計トークンコストを見る
skillshare analyze claude --json --filter frontend

# TUI の検索ボックスを事前入力する
skillshare analyze --filter marketing

オプション

フラグ	説明
`[target]`	単一 Target の詳細を表示（自動的に verbose を有効化）
`--verbose`, `-v`	Target ごとに説明文が最も長い上位 10 件を表示
`--no-tui`	インタラクティブ TUI を無効化し、プレーンテキストで出力
`--project`, `-p`	Project レベルの Skill（`.skillshare/`）を分析
`--global`, `-g`	グローバルの Skill（`~/.config/skillshare`）を分析
`--filter <text>`	名前/パスの部分文字列で Skill をフィルタ
`--json`	JSON として出力（スクリプト/CI 向け）
`--help`, `-h`	ヘルプを表示

自動検出

--project も --global も指定しない場合、skillshare は自動検出します。カレントディレクトリに .skillshare/config.yaml が存在すれば Project mode、それ以外はグローバルモードになります。

JSON 出力

skillshare analyze --json

{
  "targets": [
    {
      "name": "claude",
      "skill_count": 7,
      "always_loaded": {
        "chars": 1448,
        "estimated_tokens": 362
      },
      "on_demand_max": {
        "chars": 88,
        "estimated_tokens": 22
      },
      "skills": [
        {
          "name": "my-skill",
          "description_chars": 180,
          "description_tokens": 45,
          "body_chars": 400,
          "body_tokens": 100,
          "lint_issues": [
            {
              "rule": "no-trigger-phrase",
              "severity": "warning",
              "category": "format",
              "message": "Description lacks trigger phrases (e.g. 'Use when...'); agents may not know when to invoke this skill"
            }
          ]
        }
      ]
    }
  ]
}

Lint の問題がない Skill では lint_issues フィールドは省略されます。

Project mode

skillshare analyze -p                  # Project の Skill のインタラクティブ TUI
skillshare analyze -p --verbose        # Verbose テキスト出力
skillshare analyze -p claude           # 単一 Target の詳細
skillshare analyze -p --json           # JSON 出力

フィルタリング

--filter を使うと、結果を Skill のサブセットに絞り込めます。フィルタは Skill の相対パス（グループディレクトリを含む）に対して大文字小文字を区別しない部分一致で行われます。

例えば、--into frontend で Skill をインストールした場合:

--filter frontend は frontend/ グループ内のすべての Skill にマッチ
--filter react はパスに "react" を含む任意の Skill にマッチ

TUI モードでは、--filter はフィルタ入力欄を事前入力します。インタラクティブにフィルタするには / キーも使用できます。

JSON モードでは、出力に集計済みのトークン数を含む filtered_summary が含まれます。

{
  "filter": "frontend",
  "matched_count": 5,
  "total_count": 50,
  "filtered_summary": {
    "always_loaded": { "chars": 2400, "tokens": 600 },
    "on_demand": { "chars": 8000, "tokens": 2000 },
    "total": { "chars": 10400, "tokens": 2600 }
  },
  "skills": [...]
}

Web UI でも、検索やフィルタが有効なときは動的なトークンサマリーバーが表示されます。

予算の警告

context_budget の閾値が設定されている場合、analyze はいずれかの Target が予算を超えていると警告を表示します。設定の詳細については sync — Context Cost を参照してください。

使うタイミング​

コンテキスト予算を最適化する​

Target 間で比較する​

Skill の品質を確認する​

CI/スクリプト​

実行内容​

Skill 品質 Lint​

インタラクティブ TUI​

色分け​

出力例​

デフォルト（--no-tui）​

詳細​

単一 Target​

グループでフィルタする​

オプション​

JSON 出力​

Project mode​

フィルタリング​

予算の警告​

関連項目​