/extras

sidebar_position: 2

extras

Skill と一緒に sync される、Skill 以外のリソース（rules、commands、prompts など）を管理します。

概要

Extras は skillshare が管理する追加のリソースタイプです — いわば「Skill 以外のコンテンツ用の Skill」と考えてください。よくある用途としては、AI の rules、エディタの commands、prompt テンプレートをツール間で sync することが挙げられます。

各 Extras は以下を持ちます。

• **名前**（例: `rules`、`prompts`、`commands`）
• **Source ディレクトリ** — `extras_source` または Extras ごとの `source` で設定可能。デフォルトは `~/.config/skillshare/extras/<name>/`（グローバル）または `.skillshare/extras/<name>/`（Project）
• 同期先となる 1 つ以上の **Target**

コマンド

`extras init`

新しい Extras リソースタイプを作成します。

# インタラクティブウィザード
skillshare extras init

# CLI フラグ
skillshare extras init <name> --target <path> [--target <path2>] [--mode <mode>]

**オプション:**

| フラグ | 説明 | |------|-------------| | `--target <path>` | Target ディレクトリのパス（複数指定可） | | `--mode <mode>` | sync モード: `merge`（デフォルト）、`copy`、または `symlink` | | `--flatten` | サブディレクトリ内のファイルを Target のルート直下に sync する（`symlink` モードとは併用不可） | | `--source <path>` | この Extras 用のカスタム Source ディレクトリ（`extras_source` とデフォルトを上書き。**グローバルモードのみ**） | | `--force` | すでに存在する Extras を上書き | | `--no-tui` | インタラクティブウィザードをスキップし、CLI フラグのみを使用 | | `--project, -p` | Project 設定（`.skillshare/`）内に作成 | | `--global, -g` | グローバル設定内に作成 |

:::note `--source` はグローバルモードでのみサポートされています。Project mode では常に `.skillshare/extras/<name>/` が Source ディレクトリとして使われます。 :::

**例:**

# rules を Claude と Cursor に sync
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules

# カスタムの Source ディレクトリを使う
skillshare extras init rules --target ~/.claude/rules --source ~/company-shared/rules

# 既存の Extras を新しい Target で上書きする
skillshare extras init rules --target ~/.cursor/rules --force

# copy モードの Project スコープ Extras
skillshare extras init prompts --target .claude/prompts --mode copy -p

# agents をフラットに sync（Claude Code のようなツールはフラットなファイルしか検出しない）
skillshare extras init agents --target ~/.claude/agents --flatten

`extras list`

設定済みのすべての Extras と、その sync 状態を一覧表示します。デフォルトでインタラクティブ TUI を起動します。

skillshare extras list [--json] [--no-tui] [-p|-g]

**オプション:**

| フラグ | 説明 | |------|-------------| | `--json` | JSON 出力（`source_type`: `per-extra` / `extras_source` / `default`、および設定されている場合は Target ごとの `extension` フィールドを含む） | | `--no-tui` | インタラクティブ TUI を無効化し、プレーンテキスト出力を使用 | | `--project, -p` | Project モードの Extras（`.skillshare/`）を使用 | | `--global, -g` | グローバルの Extras（`~/.config/skillshare/`）を使用 |

インタラクティブ TUI

TUI は、左側に Extras リスト、右側に詳細パネルを配置した分割ペイン UI を提供します。キーバインド:

| キー | 動作 | |-----|--------| | `↑↓` | リストを移動 | | `/` | 名前でフィルタ | | `Enter` | コンテンツビューア（Source ファイルを閲覧） | | `N` | 新しい Extras を作成 | | `X` | Extras を削除（確認あり） | | `S` | Extras を Target に sync | | `C` | Target から collect | | `M` | Target の sync モードを変更 | | `F` | Target の flatten を切り替え | | `Ctrl+U/D` | 詳細パネルをスクロール | | `q` / `Ctrl+C` | 終了 |

各行のカラーバーは、集約された sync 状態を反映します: シアン = すべて sync 済み、黄色 = drift、赤 = 未 sync、灰色 = Source なし。

複数 Target を持つ Extras の場合、`S`、`C`、`M`、`F` は Target のサブメニューを開きます。`S` と `C` はすべての Target を一括選択できますが、`M` と `F` は特定の Target を選ぶ必要があります。

TUI は `skillshare tui off` で完全に無効化できます。

プレーンテキスト出力

TUI が無効な場合（`--no-tui`、`skillshare tui off`、またはパイプされた出力）:

$ skillshare extras list --no-tui

Extras
─────────────────────────────────────────
→ rules  ~/.config/skillshare/extras/rules/ · 2 files
  ✓ ~/.claude/rules  merge
  ✓ ~/.cursor/rules  copy

→ codex-agents  ~/.config/skillshare/agents · 3 files
  ✓ ~/.codex/agents  extension: codex-agents

sync 済みの行にはアイコン、パス、モードのみが表示されます。未 sync の行にはステータス語（`drift`、`not synced`、`no source`）が追記されます。変換拡張子（extension）を持つ Target は、sync モードの代わりに `extension: <name>` と表示されます（実際のモードは常に `copy` です）。

`extras source`

グローバルな `extras_source` ディレクトリを表示または設定します。これは Extras の Source ファイルが格納されるデフォルトの親ディレクトリです。

skillshare extras source            # 現在の値を表示
skillshare extras source <path>     # 新しい値を設定

引数なしの場合、現在の `extras_source` パスを表示します（自動検出された場合は `(default)` が付きます）。パスを引数に渡すと、グローバル設定の `extras_source` を更新します。

:::note このコマンドはグローバル専用です。Project mode では常に `.skillshare/extras/` が使われ、`extras_source` はサポートされません。 :::

**例:**

# 現在の extras_source を表示
skillshare extras source

# 共有ディレクトリに設定
skillshare extras source ~/company-shared/extras

既存の Extras を操作する

`extras <name>` へのフラグを通じて、Target の sync モードや flatten 設定の変更、Target の追加・削除を行います。これらは設定のみの変更のため、変更をディスクに適用するには後で `skillshare sync extras` を実行してください。

skillshare extras <name> --mode <mode> [--target <path>] [-p|-g]
skillshare extras <name> --flatten | --no-flatten [--target <path>]
skillshare extras <name> --add-target <path> [--mode <mode>] [--flatten] [-p|-g]
skillshare extras <name> --remove-target <path> [--prune] [-p|-g]

**オプション:**

| フラグ | 説明 | |------|-------------| | `--mode <mode>` | 新しい sync モード: `merge`、`copy`、または `symlink` | | `--flatten` | flatten を有効化（サブディレクトリのファイルを Target ルートに sync） | | `--no-flatten` | flatten を無効化 | | `--add-target <path>` | Extras に新しい Target を追加 | | `--remove-target <path>` | Extras から Target を削除（デフォルトでは設定のみ） | | `--prune` | `--remove-target` と併用: その Target 配下の skillshare 管理ファイルも削除 | | `--target <path>` | Target ディレクトリのパス（複数 Target を持つ Extras で `--mode` を使う場合は必須。省略時、`--flatten`/`--no-flatten` はすべての Target に適用される） | | `--project, -p` | Project モードの Extras（`.skillshare/`）を使用 | | `--global, -g` | グローバルの Extras（`~/.config/skillshare/`）を使用 |

**例:**

# rules のモードを変更（単一 Target — 自動解決）
skillshare extras rules --mode copy

# Target を明示的に指定する（複数 Target の Extras では必須）
skillshare extras rules --mode copy --target ~/.claude/rules

# すべての Target で flatten を一括有効化/無効化
skillshare extras agents --flatten
skillshare extras agents --no-flatten

# 既存の Extras に新しい Target を追加する（その後 sync）
skillshare extras rules --add-target ~/.cursor/rules
skillshare extras commands --add-target ~/.config/opencode/commands --mode copy

# Target を削除する（sync 済みファイルはそのまま残す）
skillshare extras rules --remove-target ~/.cursor/rules

# Target を削除し、その sync 済みファイルも削除する
skillshare extras rules --remove-target ~/.cursor/rules --pr