/list

sidebar_position: 4

list

ソースディレクトリにインストールされているすべての Skill を一覧表示します。

skillshare list              # インタラクティブ TUI（TTY でのデフォルト）
skillshare list --verbose    # 詳細なプレーンテキスト表示
skillshare list --json       # CI/スクリプト向けの JSON 出力

こんなときに使う

• どの Skill がインストールされていて、どこから来たかを確認する
• Skill をインタラクティブに検索・フィルタする
• どの Skill がトラック対象リポジトリで、どれがローカルかを確認する
• クリーンアップ前に Skill コレクションを監査する


インタラクティブ TUI

TTY 上では、`skillshare list` は次の機能を持つインタラクティブなターミナル UI を起動します。

• **スマートフィルタ** — `/` を押して名前・パス・ソースでフィルタします。正確なフィルタリングのためのタグ構文もサポートしています。

| タグ | 短縮形 | 値 | 例 | |-----|-------|--------|---------| | `type:` | `t:` | `tracked`, `remote`, `local`, `github` | `t:tracked` | | `group:` | `g:` | 任意のディレクトリ名 | `g:security` | | `repo:` | `r:` | 任意のリポジトリ名 | `r:team` | | `kind:` | `k:` | `skill`, `agent` | `k:agent` | | `status:` | `s:` | `enabled`, `disabled` | `s:disabled` |

タグは自由テキストと組み合わせられます（AND ロジック）。

  t:tracked g:security audit

これは、"security" グループ内のトラック対象 Skill のうち、名前に "audit" を含むものだけを表示します。

:::tip enabled/disabled のフィルタリングには、通常タグは不要です — 単に `s` を押してください （下記の **ステータスフィルタ** を参照）。`s:enabled` / `s:disabled` タグは、 他のタグと組み合わせる場合に使います。例: `t:tracked s:disabled`。 :::

• **ステータスフィルタ** — `s` を押すと enabled/disabled ビューを循環します: **All → Enabled → Disabled → All**。現在の状態はタブバーの隣に `Status:` チップとして表示されるため、大きなリストでも `.skillignore` で無効化された Skill だけに即座に絞り込む（または隠す）ことができます。タブや `/` フィルタと組み合わせて使えます。
• **キーボードナビゲーション** — 矢印キーで移動、`q` で終了
• **詳細パネル** — 選択した Skill の説明、ディスクパス、ファイル、sync 済みターゲットを表示
• **Enable/Disable トグル** — `E` を押すと選択した Skill の enabled/disabled 状態を切り替えます。TUI を抜けることなく `.skillignore` に即座に書き込みます。Disabled な Skill は詳細パネルに赤い **disabled** バッジで表示されます。
• **Manual only トグル** — `M` を押すと、選択した Skill の `SKILL.md` 内の `disable-model-invocation` を切り替えます。Skill はインストールされたままで、名前を指定して呼び出すことは引き続きできますが、モデルが自発的に読み込むことはなくなり、詳細パネルには **manual only** バッジが表示されます。`E` とは異なり、これは Skill ファイル自体を編集します。トラック対象またはインストール済みの Skill の場合、TUI は先に確認します。なぜなら `skillshare update` はローカルに変更があるトラック対象リポジトリをスキップし、Skill の再インストールはこの編集を消してしまうからです。もう一度 `M` を押すと、その行が削除され、ファイルは元どおりに復元されます。Agent は影響を受けません。[ダッシュボード](/docs/reference/commands/ui) にも同じ **manual only** タグが表示され、Skill エディタに切り替えスイッチがあります。
• **コンテンツビューア** — `Enter` を押すと、左側にファイルツリー、右側に Markdown レンダリングされたコンテンツを表示するデュアルペインビューアが開きます。`j`/`k` でファイルを閲覧（自動プレビュー）、`l`/`Enter` でディレクトリを展開、`h` で折りたたみます。`Ctrl+d`/`u` でコンテンツを半ページスクロール、`g`/`G` で先頭/末尾へジャンプします。マウスホイールとクリックもサポートされています。

TUI をスキップしてプレーンテキストを出力するには `--no-tui` を使用します。

skillshare list --no-tui          # プレーンテキスト出力
skillshare list --no-tui | less   # 手動でページャにパイプ

検索とフィルタ

TUI に入らずに Skill をフィルタします。

skillshare list react                     # 名前/パス/ソースでフィルタ
skillshare list --type local              # ローカル Skill のみ
skillshare list --type github             # GitHub ソースの Skill のみ
skillshare list --status disabled         # .skillignore で無効化された Skill のみ
skillshare list --status enabled --json   # 有効な Skill を JSON で
skillshare list react --sort newest       # インストール日でソート
skillshare list --json | jq '.[].name'   # スクリプト向けの JSON

デフォルトのビュー（`--status all`）には disabled とマークされたエントリも含まれます。`--status` はパターンや `--type` と AND 条件で組み合わされ、プロジェクトモードや `list agents` / `list --all` でも動作し、TUI の `Status:` チップの初期値になります （そこからも `s` を押して循環できます）。

:::tip AI での利用 Skill をプログラムから調べる場合は `--json` モードを使用してください。

skillshare list --json | jq '.[] | {name, source, type}'

:::

出力例

コンパクトビュー

フォルダを使って整理している場合、Skill は自動的にディレクトリごとにグルーピングされます。

Installed skills
─────────────────────────────────────────

  frontend/
    → react-helper        github.com/user/skills
    → vue-helper          github.com/user/skills

  → my-skill              local
  → commit-commands       github.com/user/skills
  → old-draft             local  [disabled]

Tracked repositories
─────────────────────────────────────────
  ✓ _team-skills          3 skills, up-to-date

すべての Skill がトップレベル（フォルダなし）にある場合、出力はフラットなリストになります — 以前のバージョンと同一です。

Verbose ビュー

skillshare list --verbose

Installed skills
─────────────────────────────────────────

  frontend/
    react-helper
      Source:      github.com/user/skills
      Type:        github
      Installed:   2026-01-15

    vue-helper
      Source:      github.com/user/skills
      Type:        github
      Installed:   2026-01-15

  my-skill
    Source:      (local - no metadata)

  commit-commands
    Source:      github.com/user/skills
    Type:        github
    Installed:   2026-01-15

Tracked repositories
─────────────────────────────────────────
  ✓ _team-skills          3 skills, up-to-date
  ! _other-repo           5 skills, has changes

グローバル vs プロジェクト

skillshare は 2 つのレベルで動作します。`list` コマンドは、アクティブなレベルの Skill を表示します。

flowchart TD
    subgraph GLOBAL["GLOBAL"]
        G_SRC["~/.config/skillshare/skills/"]
        G_CMD["list / list -g"]
        G_CMD --> G_SRC
    end
    subgraph PROJECT["PROJECT"]
        P_SRC[".skillshare/skills/"]
        P_CMD["list -p"]
        P_CMD --> P_SRC
    end

| | Global | Project | |---|---|---| | **ソース** | `~/.config/skillshare/skills/` | `.skillshare/skills/` | | **フラグ** | `-g` またはデフォルト | `-p` または自動検出 | | **範囲** | マシン上のすべてのプロジェクト | 単一のリポジトリ | | **共有方法** | `push` / `pull` | git commit |

自動検出

フラグなしで `skillshare list` を実行すると、skillshare は自動的にモードを検出します。

flowchart LR
    CMD["skillshare list"] --> CHECK{".skillshare/config.yaml exists?"}
    CHECK -- YES --> PROJ["Project mode"]
    CHECK -- NO --> GLOB["Global mode"]

cd my-project/            # .skillshare/config.yaml がある
skillshare list           # → Installed skills (project)

cd ~
skillshare list           # → Installed skills (global)

自動検出を上書きするには `-p` または `-g` を使用します。

skillshare list -g        # プロジェクト内でも強制的にグローバル
skillshare list -p        # 自動検出なしでも強制的にプロジェクト

プロジェクトモード

skillshare list          # .skillshare/ が存在すれば自動検出
skillshare list -p       # 明示的にプロジェクトモード

出力例

``