list

列出 source 目錄中所有已安裝的 skills。

skillshare list              # 互動式 TUI（TTY 下的預設值）
skillshare list --verbose    # 詳細的純文字檢視
skillshare list --json       # 供 CI/腳本使用的 JSON 輸出

啟用 follow_source_links: true 時，無法使用的第一層來源連結會顯示包含連結名稱的警告，正常技能仍會列出。使用 --json 時，警告寫入 stderr，stdout 保持有效的 JSON。

何時使用

查看已安裝哪些 skills 以及它們的來源
互動式搜尋與篩選 skills
檢查哪些 skills 是 tracked repos、哪些是 local
在清理前稽核你的 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 會開啟互動式畫面，skills 與 agents 各在一個分頁：左側是清單，右側是選取項目的詳細資訊。在這裡可以更新、解除安裝或檢查（audit）skill，開關 skill（立即寫入 .skillignore），以及閱讀它的檔案。常用按鍵列在畫面底部，按 ? 可看全部按鍵。

智慧篩選 — 按 / 依名稱、路徑或來源篩選。支援 tag 語法做精準篩選：

Tag 縮寫值範例
type: t: tracked、remote、local、github t:tracked
group: g: 任意目錄名稱 g:security
repo: r: 任意 repo 名稱 r:team
kind: k: skill、agent k:agent
status: s: enabled、disabled s:disabled

Tags 可以與純文字組合（AND 邏輯）：
```
t:tracked g:security audit
```
這會只顯示「security」群組中、名稱包含「audit」的 tracked skills。
僅手動切換 — 按 m 切換選取 skill SKILL.md 中的 disable-model-invocation。該 skill 仍保持已安裝，你仍可用名稱呼叫它，但模型不會再自動載入它；詳細面板會顯示 manual only 徽章。與 t 不同，這會編輯 skill 檔案本身：對於 tracked 或已安裝的 skill，TUI 會先詢問，因為 skillshare update 會跳過有本地變更的 tracked repos，而重新安裝 skill 會丟失這項編輯。再按一次 m 會移除該行並完整還原檔案。Agents 不受影響。dashboard 顯示相同的 manual only 標籤，並在其 skill 編輯器中提供切換開關。

Tag	縮寫	值	範例
`type:`	`t:`	`tracked`、`remote`、`local`、`github`	`t:tracked`
`group:`	`g:`	任意目錄名稱	`g:security`
`repo:`	`r:`	任意 repo 名稱	`r:team`
`kind:`	`k:`	`skill`、`agent`	`k:agent`
`status:`	`s:`	`enabled`、`disabled`	`s:disabled`

使用 --no-tui 跳過 TUI，改印出純文字：

skillshare list --no-tui          # 純文字輸出
skillshare list --no-tui | less   # 手動 pipe 到 pager

搜尋與篩選

不進入 TUI 也能篩選 skills：

skillshare list react                     # 依名稱/路徑/來源篩選
skillshare list --type local              # 只顯示 local skills
skillshare list --type github             # 只顯示 GitHub 來源的 skills
skillshare list --status disabled         # 只顯示透過 .skillignore 停用的 skills
skillshare list --status enabled --json   # 已啟用的 skills，以 JSON 輸出
skillshare list react --sort newest       # 依安裝日期排序
skillshare list --json | jq '.[].name'   # 供腳本使用的 JSON

預設檢視（--status all）包含標記為停用的項目。--status 會與 pattern 及 --type 以 AND 邏輯組合，在 project mode 以及 list agents / list --all 中都能運作，並會以相同方式縮小 TUI 的範圍， TUI 最上面一行會顯示例如 disabled only。在 TUI 裡請改在篩選中輸入 s:disabled。

AI Usage

以程式化方式檢查 skills 時，使用 --json 模式：

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

輸出範例

精簡檢視

當你用資料夾組織 skills 時，會自動依目錄分組：

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

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

如果所有 skills 都在最上層（沒有資料夾），輸出會是平面清單 — 與先前版本相同。

詳細檢視

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
! _other-repo   has changes · 5 skills

12 skills · 8 tracked, 3 remote, 1 local

Global vs Project

skillshare 在兩個層級運作。list 指令會顯示目前作用層級的 skills：

	Global	Project
Source	`~/.config/skillshare/skills/`	`.skillshare/skills/`
旗標	`-g` 或預設	`-p` 或自動偵測
範圍	機器上所有專案	單一 repository
共享方式	`push` / `pull`	git commit

自動偵測

當你不加旗標執行 skillshare list 時，skillshare 會自動偵測 mode：

cd my-project/            # 有 .skillshare/config.yaml
skillshare list           # → Skills · project

cd ~
skillshare list           # → Skills

使用 -p 或 -g 覆寫自動偵測：

skillshare list -g        # 強制 global，即使在專案內也一樣
skillshare list -p        # 強制 project，即使沒有自動偵測

Project Mode

skillshare list          # 若 .skillshare/ 存在則自動偵測
skillshare list -p       # 明確指定 project mode

輸出範例

Skills · project
  tools/
    pdf     anthropic/skills/pdf
    review  github.com/team/tools
  my-skill  local

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

Project list 使用與 global list 相同的視覺格式，標題會加上 · project 標籤。Skills 依目錄分組，並依有無 metadata 分類為 local（無 metadata）或依來源 URL 分類（remote）。

選項

旗標	說明
`[pattern]`	依名稱、路徑或來源篩選 skills（不分大小寫）
`--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`	列出專案 skills
`--global, -g`	列出全域 skills
`--help, -h`	顯示說明

目錄分組

當 skills 透過資料夾組織（--into 安裝時，或手動 mv + sync）時，list 會自動依目錄分組：

  frontend/
    react-helper  github.com/user/skills
    vue-helper    github.com/user/skills
  my-skill        local

同一資料夾下的 skills 共用一個群組標題（例如 frontend/）
每個群組內，只顯示基礎名稱（而非完整路徑）
頂層 skills（無父層資料夾）會以無群組方式顯示在最下方
如果所有 skills 都在頂層，輸出會是平面清單 — 沒有群組標題

分組是根據你 source 目錄內的目錄結構，而非某個旗標。要開始使用，請用 --into 組織 skills：

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

更多細節見 Organizing Skills with Folders。

理解輸出內容

Skill 來源

標籤	意義
`local`	本地建立，沒有 metadata
`github.com/...`	從 GitHub 安裝
`tracked: <repo>`	屬於某個 tracked repository
`[disabled]`	透過 `.skillignore` 排除的 skill（見 enable/disable）

Repository 狀態

圖示	意義
`✓`	最新，沒有本地變更
`!`	有未提交的變更
`!` + 警告	Git 狀態不明（無法讀取）；會有一行警告指出該 repo 與錯誤

Agent 支援

skillshare list agents 會篩選成只顯示 agents，也就是 agents source 目錄（~/.config/skillshare/agents/ 或 .skillshare/agents/）中的 .md 檔案。

skillshare list agents              # 只列出 agents
skillshare list agents --json       # agents 的 JSON 輸出
skillshare list agents --verbose    # 詳細的 agent 清單

在互動式 TUI 中，agents 會顯示 [A] 徽章以與 skills 區別。所有 TUI 功能（篩選、詳細面板、啟用/停用切換）運作方式相同。

不加 agents 參數時，list 只顯示 skills（預設行為）。背景說明見 Agents。

另見

enable / disable — 在不移除的情況下切換 skills
install — 安裝 skills
uninstall — 移除 skills
status — 顯示同步狀態
Agents — Agent 概念

何時使用​

互動式 TUI​

搜尋與篩選​

輸出範例​

精簡檢視​

詳細檢視​

Global vs Project​

自動偵測​

Project Mode​

輸出範例​

選項​

目錄分組​

理解輸出內容​

Skill 來源​

Repository 狀態​

Agent 支援​

另見​

何時使用

互動式 TUI

搜尋與篩選

輸出範例

精簡檢視

詳細檢視

Global vs Project

自動偵測

Project Mode

輸出範例

選項

目錄分組

理解輸出內容

Skill 來源

Repository 狀態

Agent 支援

另見