/list

sidebar_position: 4

list

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

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

`follow_source_links: true` の場合、利用できない最上位のソースリンクはリンク名付きの警告を表示し、正常なスキルは引き続き一覧に含まれます。`--json` では警告を stderr に出力し、stdout は有効な JSON のままです。

こんなときに使う

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

skillshare list --no-tui

Skills
  _superpowers/skills/
    brainstorming                tracked: _superpowers
    dispatching-parallel-agents  tracked: _superpowers
    systematic-debugging         tracked: _superpowers
    …
  frontend/
    react-components             local
  web/
    accessibility                github.com/addyosmani/web-quality-skills/skills...
    core-web-vitals              github.com/addyosmani/web-quality-skills/skills...
    …
  docx                           github.com/anthropics/skills/skills/docx
  frontend-design                github.com/anthropics/skills/skills/frontend-de...
  pdf                            github.com/anthropics/skills/skills/pdf
  skill-creator                  github.com/anthropics/skills/skills/skill-creator
  skillshare                     github.com/runkids/skillshare/skills/skillshare
  …

Tracked repos
✓ _superpowers  up to date · 15 skills

28 skills · 15 tracked, 9 remote, 4 local
  Add -v for sources and install dates

インタラクティブ TUI

TTY 上では、`skillshare list` は Skill と Agent を 2 つのタブに分けたインタラクティブな画面を開きます。左側がリスト、右側が選択した項目の詳細です。ここから Skill の更新、アンインストール、audit、有効/無効の切り替え（即座に `.skillignore` に書き込み）、ファイルの閲覧ができます。よく使うキーは画面下部に表示され、`?` ですべてのキーを確認できます。

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

| タグ | 短縮形 | 値 | 例 | |-----|-------|--------|---------| | `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" を含むものだけを表示します。

• **Manual only トグル** — `m` を押すと、選択した Skill の `SKILL.md` 内の `disable-model-invocation` を切り替えます。Skill はインストールされたままで、名前を指定して呼び出すことは引き続きできますが、モデルが自発的に読み込むことはなくなり、詳細パネルには **manual only** バッジが表示されます。`t` とは異なり、これは Skill ファイル自体を編集します。トラック対象またはインストール済みの Skill の場合、TUI は先に確認します。なぜなら `skillshare update` はローカルに変更があるトラック対象リポジトリとインストール済み Skill を、もう一度 `m` を押すか `--force` 付きで更新するまでスキップし、`--force` を使うとこの編集が消えてしまうからです。もう一度 `m` を押すと、その行が削除され、ファイルは元どおりに復元されます。Agent は影響を受けません。[ダッシュボード](/docs/reference/commands/ui) にも同じ **manual only** タグが表示され、Skill エディタに切り替えスイッチがあります。

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 も同じように絞り込まれます。 そのとき TUI の最上行には `disabled only` などと表示されます。TUI の中では、代わりにフィルタに `s:disabled` と入力してください。

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

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

:::

出力例

コンパクトビュー

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

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 repos
✓ _team-skills  up to date · 3 skills, 5 variants

8 skills · 3 tracked, 3 remote, 2 local
  Add -v for sources and install dates

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

Verbose ビュー

skillshare list --verbose

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
  commit-commands
    Source     github.com/user/skills
    Type       github
    Installed  2026-01-15

Tracked repos
✓ _team-skills  up to date · 3 skills, 5 variants
! _other-repo   has changes · 5 skills

12 skills · 8 tracked, 3 remote, 1 local

グローバル 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           # → Skills · project

cd ~
skillshare list           # → Skil