/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 → Folders & files** には、各 Extras とその Target、モードが並びます。


コマンド

`extras memory` {#extras-memory}

`memory` extra の共有 Markdown ノートを管理します。任意のテキストエディターを使えます。 [スクリーンショット付きガイド](../../how-to/daily-tasks/sharing-memory)で作成から Agent への接続まで確認できます。

| サブコマンド | 動作 | |---|---| | `init` | Target のない memory extra を登録し、不足する `INDEX.md` と `LEARNED.md` を作成。既存のファイルと設定は保持 | | `list` | ノート一覧。`--search <text>` でサブフォルダーを含むパスと内容を大文字小文字を区別せず検索 | | `show <note.md>` | ノートを読む。`--json` は `version` hash を含む | | `write <note.md> --from <file\|->` | ファイルまたは stdin から書き込む。新規作成では `--version` を省略し、更新には最後に読んだ version が必要 | | `delete <note.md> --version <hash>` | バックアップ後に指定 version を削除。古い version や未指定の version は拒否 | | `instructions` | 実際の source フォルダーを指す読み込み指示を出力。どちらのモードも各タスクの開始時に `INDEX.md` を読みます。`--update-mode passive`（既定）は残す価値のある事実を指摘させ、更新は依頼時だけ行わせます。`--update-mode active` はそうした事実をツール自身のメモリではなくここに保存させ、迷うときは提案させます |

各サブコマンドは `--json`、`-g` / `--global`、`-p` / `--project`、`--help` に対応します。 Scope は未指定なら自動検出。既定の global パスは `~/.config/skillshare/extras/memory/`、 Project は `.skillshare/extras/memory/` です。既存の extras source 設定が適用されます。

ノートは相対 `.md` パスの UTF-8 ファイルで、最大 1 MiB。隠しファイル、隠しフォルダー、内部のシンボリックリンクは除外します。大きすぎるファイルや非 UTF-8 ファイルは未対応として一覧に残り、他の有効なノートは使えます。`wiki/architecture.md` は不足するフォルダーを自動作成します。Dashboard はツリー、**Preview** / **Source**、**Copy path**、**Edit**、**Delete note**、**History** を提供します。**Move or rename** は新しい相対 `.md` パスを指定し、不足するフォルダーを作成します。内容と権限を保持し、既存の移動先や古い version は拒否します。移動前に元のパスをバックアップします。Markdown リンクは手動で修正してください。Agent のガイダンスが参照する source 直下の `INDEX.md` はその場所に維持してください。

保存は最後に読んだ version を確認します。競合時は下書きを保持し、最新の保存内容を比較用に表示します。**Save my draft** は確認後に更新された version を使い、保存済み内容をバックアップして置換します。削除も確認、version 検証、バックアップを行います。**History** と削除後の復元リンクは、ノートの絶対パスで絞り込んだ **Backup Files** を開きます。CLI では `backup files show <absolute-path>` と `backup files restore <absolute-path> <id>` を使います。

**New note** の **Link from INDEX.md** はインデックスが読み取り可能な場合に表示され、既定でオンです。末尾にリンクを追加し、version を確認してバックアップします。失敗しても新しいノートは残ります。**Add to INDEX** で未登録のノートを追加できます。リンク切れは警告を表示しますが、自動削除はしません。CLI の書き込みはリンクを追加しません。

**Connect to agents** でツールとそれぞれの更新モード（`passive` または `active`）を選び、**Review changes** → **Apply changes** を実行します。同じファイルを読むツールは 1 つのブロックを共有し、モードも一緒に切り替わります。設定済みツールのモードも同じレビューで変更できます。既存の指示ファイルまたは共有 source に scope/hash マーカー付きブロックを追加・更新し、他の内容と割り当ては保持します。変更、他の読み取りツール、既知の文字数制限を確認できます。既存ファイルをバックアップし、古いプランを拒否します。変更されていない古いブロックはレビュー後に更新でき、手動変更済みや不正なブロックは保持します。未同期または読めない指示ファイルはスキップします。

**Configured** は現在の指示が読み取り経路にある状態で、読み取り済みを意味しません。**Memory tools → Try across sessions** で保存、新しい会話での読み取り、削除用プロンプトをコピーします。読み取り用には一時的な検証値を含めません。実際の読み取りイベント、完全なパス、返された値を手動で確認してください。読み取り telemetry は保証しません。

**Copy guidance** は手動貼り付けの代替手段で、モードを選んでコピーします。**Open AGENTS.md** から編集できます。Project 内の source は指示ファイルの場所に関係なく **project root** からの相対パス、Project 外や global の source は絶対パスです。移動後は再生成してください。CLI の `instructions` も同じ scope/hash ブロックを出力します。Native automatic memory、自動学習、Obsidian 連携は有効になりません。

`extras init`

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

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

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

# 単一ファイルの Extras
skillshare extras init <name> --file <filename> [--as <filename>] --target <path> [--source <dir>] [--mode <mode>]

ウィザードは名前の後に **What do you want to sync?** と尋ねます。**Folder** または **Single file** を選びます。

**オプション:**

| フラグ | 説明 | |------|-------------| | `--target <path>` | Target ディレクトリのパス（複数指定可） | | `--file <filename>` | Source ディレクトリ内のこのファイルだけを sync し、[単一ファイルの Extras](#single-file-extras) にする。`/` や `\` を含まない単純なファイル名 | | `--as <filename>` | すべての Target で書き出すファイル名（デフォルト: `--file` の名前）。`--file` が必要 | | `--mode <mode>` | sync モード: `merge`（デフォルト）、`copy`、または `symlink`。`import` は `--file` 指定時のみ | | `--flatten` | サブディレクトリ内のファイルを Target のルート直下に sync する（`symlink` モードや `--file` とは併用不可） | | `--include <pattern>` | 一致するファイルだけを sync する（[ファイルフィルター](#choosing-files)）。複数指定可。`symlink` モードや `--file` とは併用不可 | | `--exclude <pattern>` | 一致するファイルをスキップする（[ファイルフィルター](#choosing-files)）。複数指定可。`symlink` モードや `--file` とは併用不可 | | `--source <path>` | この Extras 用のカスタム Source ディレクトリ（`extras_source` とデフォルトを上書き。Project モードではプロジェクトルートからの相対パス） | | `--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

# 1 つのファイルを sync し、Target では名前を変える
skillshare extras init pi-prompt --file system.md --as APPEND_SYSTEM.md \
  --source ~/dotfiles/prompts --target ~/.pi/agent

`extras init` は設定を書き込むだけです。Source ファイルの作成や sync は行いません。単一ファイルの Extras では、Source と Target のファイルのフルパスを表示します。

  Source    ~/dotfiles/prompts/system.md
  Target    ~/.pi/agent/APPEND_SYST