list

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

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

こんなときに使う

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

list demo

インタラクティブ 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" を含むものだけを表示します。

ヒント

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 は影響を受けません。ダッシュボードにも同じ 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 を押して循環できます）。

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 を表示します。

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

自動検出

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

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       # 明示的にプロジェクトモード

出力例

Installed skills (project)
─────────────────────────────────────────

  tools/
    → pdf               anthropic/skills/pdf
    → review            github.com/team/tools

  → my-skill            local

→ 3 skill(s): 2 remote, 1 local

プロジェクトの list は、ヘッダーに (project) ラベルが付く点を除き、グローバルの list と同じ表示形式を使います。Skill はディレクトリごとにグルーピングされ、local（メタデータなし）またはソース URL（リモート）で分類されます。

オプション

フラグ	説明
`[pattern]`	名前・パス・ソースで Skill をフィルタ（大文字小文字を区別しない）
`--verbose, -v`	詳細情報を表示（ソース、種類、インストール日）
`--json, -j`	JSON として出力（CI/スクリプトに便利）
`--no-tui`	インタラクティブ TUI を無効化し、プレーンテキストを出力
`--type, -t <type>`	種類でフィルタ: `tracked`, `local`, `github`
`--status <status>`	ステータスでフィルタ: `all`（デフォルト）, `enabled`, `disabled`
`--sort, -s <order>`	ソート順: `name`（デフォルト）, `newest`, `oldest`
`--project, -p`	プロジェクトの Skill を一覧表示
`--global, -g`	グローバルの Skill を一覧表示
`--help, -h`	ヘルプを表示

ディレクトリのグルーピング

Skill が（install 時の --into や、手動の mv + sync によって）フォルダに整理されている場合、list は自動的にディレクトリごとにグルーピングします。

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

  → my-skill              local

同じフォルダ配下の Skill はグループヘッダー（例: frontend/）を共有します
各グループ内では、フルパスではなくベース名のみが表示されます
トップレベルの Skill（親フォルダなし）はグループ化されずに末尾に表示されます
すべての Skill がトップレベルにある場合、出力はフラットなリストになり、グループヘッダーは表示されません

グルーピングはフラグではなく、ソースディレクトリ内のディレクトリ構造に基づきます。利用を開始するには、--into で Skill を整理してください。

skillshare install owner/repo -s react-patterns --into frontend
skillshare install owner/repo -s vue-patterns --into frontend

詳細は Organizing Skills with Folders を参照してください。

出力の見方

Skill のソース

ラベル	意味
`local`	ローカルで作成、メタデータなし
`github.com/...`	GitHub からインストール
`tracked: <repo>`	トラック対象リポジトリの一部
`[disabled]`	`.skillignore` により除外された Skill（enable/disable を参照）

リポジトリのステータス

アイコン	意味
`✓`	最新の状態、ローカル変更なし
`!`	コミットされていない変更がある

Agent サポート

skillshare list agents は agent のみに絞り込み、agent のソースディレクトリ（~/.config/skillshare/agents/ または .skillshare/agents/）から .md ファイルを表示します。

skillshare list agents              # agent のみを一覧表示
skillshare list agents --json       # agent の JSON 出力
skillshare list agents --verbose    # agent の詳細一覧

インタラクティブ TUI では、agent は Skill と区別するために [A] バッジで表示されます。すべての TUI 機能（フィルタリング、詳細パネル、enable/disable トグル）は同じように動作します。

agents 引数を指定しない場合、list は Skill のみを表示します（デフォルトの動作）。背景については Agents を参照してください。

こんなときに使う​

インタラクティブ TUI​

検索とフィルタ​

出力例​

コンパクトビュー​

Verbose ビュー​

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

自動検出​

プロジェクトモード​

出力例​

オプション​

ディレクトリのグルーピング​

出力の見方​

Skill のソース​

リポジトリのステータス​

Agent サポート​

関連項目​