/uninstall

sidebar_position: 3

uninstall

source ディレクトリから 1 つ以上の skill または tracked repository を削除します。Skill は trash に移動され、自動クリーンアップまで 7 日間保持されます。

checkout のない global の tracked 宣言は、メタデータだけを削除できます。下の「トラック対象リポジトリ」を参照してください。

skillshare uninstall my-skill              # 単一の skill を削除
skillshare uninstall a b c --force         # 複数の skill を一度に削除
skillshare uninstall --all                 # すべての skill を削除
skillshare uninstall --group frontend      # グループ内のすべての skill を削除
skillshare uninstall team-repo             # tracked repository を削除（_ prefix は省略可能）

使うタイミング

• 不要になった skill を削除する（7 日間 trash に移動される）
• 使わなくなった tracked repository を整理する
• skill のグループ全体を一度にバッチ削除する
• `--all` で**すべて**の skill を一度に削除する

$ skillshare uninstall css-review
  frontend/css-review  ~/.config/skillshare/skills/frontend/css-review · 1 file
✓ Uninstall frontend/css-review → trash, kept 7 days

Next
  skillshare sync                               remove it from claude, cursor
  skillshare trash restore frontend/css-review  undo

実行内容

flowchart TD
    TITLE["skillshare uninstall"]
    S1["1. Resolve targets"]
    S2["2. Pre-flight checks"]
    S3["3. Confirm and move to trash"]
    TITLE --> S1 --> S2 --> S3

オプション

| フラグ | 説明 | |------|-------------| | `--all` | source から**すべての** skill を削除（確認が必要） | | `--group, -G <name>` | グループ内のすべての skill を削除（前方一致、繰り返し指定可） | | `--force, -f` | 確認をスキップし、未コミットの変更を無視 | | `--dry-run, -n` | 変更を加えずにプレビュー | | `--project, -p` | カレントディレクトリの project レベルの config を使用 | | `--global, -g` | global config を使用（`~/.config/skillshare`） | | `--json` | JSON を出力し確認をスキップ；未コミットの変更がある tracked repositories には引き続き `--force` が必要 | | `--help, -h` | ヘルプを表示 |

JSON 出力

skillshare uninstall my-skill another-skill --json

{
  "removed": ["my-skill", "another-skill"],
  "failed": [],
  "skipped": 0,
  "dry_run": false,
  "duration": "0.089s"
}

global mode では、省略可能な `record_only` 配列は、checkout なしで宣言だけを削除した名前を `removed` から抜き出したものです。これらには trash エントリがなく、trash から復元できません。その他の正常に削除された項目は trash に移動します。`dry_run: true` では両配列は予定を表し、まだ何も削除していません。agent や project の削除など、該当項目がない場合は `record_only` を省略します。 CLI の uninstall ログにも省略可能な `record_only` 部分集合が記録され、JSON プレビューではログに `dry_run: true` が付きます。

`--dry-run` と組み合わせてプレビューできます。

skillshare uninstall --all --json --dry-run

解決できない入力とその理由も `failed` に含まれます。dry run や、どの入力も解決できない場合も同じです。

すべての skill のアンインストールに失敗すると、コマンドは 0 以外で終了し、`error` フィールドに各 skill 名と理由が入ります。一部だけ失敗した場合は、`failed` に名前と理由が記録され、コマンドは 0 で終了します。`uninstall agents --json` は agent が 1 つでも失敗すると 0 以外で終了し、失敗した名前を `failed` に、それぞれの理由を `error` に入れます。JSON 出力は project mode（`-p`）でも使えます。

複数の Skill

複数の skill を 1 コマンドで削除します。

skillshare uninstall alpha beta gamma --force

一部の skill が見つからない場合、コマンドは**警告を出してそれらをスキップ**し、残りの削除を続行します。失敗するのは、指定したすべての skill が無効な場合のみです。

Glob パターン

skill 名は、バッチ削除のために glob パターン（`*`、`?`、`[...]`）をサポートします。

skillshare uninstall "core-*"              # core-* に一致するすべての skill を削除
skillshare uninstall "test-?" --force      # 1 文字ワイルドカード
skillshare uninstall "core-*" "util-*"     # 複数のパターン

Glob マッチングは大文字・小文字を区別しません: `"Core-*"` は `core-auth`、`CORE-DB` などに一致します。

:::note トップレベルのマッチングのみ Glob パターンは source フォルダ内の**トップレベルのディレクトリ名**に対してマッチします。ネストされた skill（例: `frontend/react-hooks`）は `"react-*"` にマッチしません — サブディレクトリ内の skill を対象にするには `--group frontend` を使ってください。 :::

`--group` は `_dev-skills` のような[たどられた source リンク](../targets/configuration.md#follow_source_links)を拒否します。実際のチェックアウトからすべての skill を移動してしまうためです。リンクのエントリを削除するには `skillshare unlink _dev-skills` を使い、チェックアウトから skill を trash に移動するには skill を名前で指定してください（`skillshare uninstall _dev-skills/foo`）。

リンク先フォルダーの直下に `SKILL.md` がある場合、そのルート skill の uninstall は拒否されます。移動するとリンクが削除され、入れ子の skill もすべて見えなくなるためです。[`unlink`](./unlink.md) でリンクだけを削除してください。チェックアウトは変更されません。

すべて削除

`--all` を使うと、source ディレクトリからすべての skill を一度に削除できます。

skillshare uninstall --all                 # 対話式の確認
skillshare uninstall --all --force         # 確認をスキップ
skillshare uninstall --all -n              # 削除対象をプレビュー

`--all` は skill 名や `--group` と組み合わせることはできません。

:::tip シェルの Glob 保護 `skillshare uninstall *` を引用符なしで実行すると、シェルがカレントディレクトリのファイル名に `*` を展開してしまいます。skillshare はこれを検知し、代わりに `--all` を使うことを提案します。ワイルドカードは常に引用符で囲む（`"*"`）か、`--all` を使ってください。 :::

グループ削除

サブ skill を含むディレクトリを uninstall すると、skillshare はそれを自動的に**グループ**として検知し、確認を求める前に含まれる skill を一覧表示します。

Uninstalling group (5 skills)
─────────────────────────────────────────
  - feature-radar
  - feature-radar-archive
  - feature-radar-learn
  - feature-radar-ref
  - feature-radar-scan
→ Name: feature-radar
→ Path: ~/.config/skillshare/skills/feature-radar

? Uninstall group feature-radar? moved to trash for 7 days   Yes   No

`--group` フラグは、**前方一致**を使ってディレクトリ配下のすべての skill を削除します。

# frontend/ 配下のすべての skill を削除
skillshare uninstall --group frontend

# ネストされた skill も削除: frontend/react/hooks, frontend/vue/composables
skillshare uninstall --group frontend --force

# 削除対象をプレビュー
skillshare uninstall --group frontend --dry-run

グループ削除が適用される場合（自動検出されたディレクトリグループを含む）、削除された各メンバーは config（`~/.config/skillshare/config.yaml` または project mode の `.skillshare/config.yaml`）内の管理対象 `skills:` リストからも削除されます。

位置引数の名前と `--group` を組み合わせることができ、`-G` を複数回使うこともできます。

# 名前とグループを混在させる
skillshare uninstall standalone-skill -G frontend -G backend --force

# 重複は自動的に排除される
skillshare uninstall frontend/hooks -G frontend --force  # hooks は 1 回だけ削除される

トラック対象リポジトリ

既存の checkout（Git checkout へのリンクを含む）の場合:

• 未コミットの変更を確認します（上書きするには `--force` を使用）
• skillshare がリポジトリの git status を読み取れない場合は `failed to check git status` で失敗します。バッチ内の他の項目は引き続き削除され、`--force` を使うとこのチェックをスキップします
• `.gitignore` からエントリを自動的に削除します
• uninstall 時に `_` prefix は省略可能です
• `--into` でインストールしたリポジトリは `devops/_team-skills` のようにパスで指定します
• `--into` のリポジトリも末尾の `_` を省略できます。`devops/team-skills` は `devops/_team-skills` を指定します。入力したパスに既存の Skill やフォルダがある場合はそちらを優先するため、リポジトリを削除するには `_` を含むパスを指定してください。短い名前が複数に一致する場合は