Skillshare CLI
Skillshare を使用してソースを管理し、設定されたターゲットにリソースを配布します。
要求された操作に関連するリファレンスのみを参照してください。ルーティングテーブルは以下にあります。
インストールされているバージョンがこれらの例と異なる場合は、skillshare <command> --help を確認してください。
スコープとリソースの選択
- グローバル設定:
~/.config/skillshare/config.yaml。プロジェクト設定:.skillshare/config.yamlまたはskillshare/config.yaml。両方が存在する場合は隠しファイルが優先されます。 自動検出に頼らず、場所が重要な場合は-gまたは-pを明示的に使用してください。 - スキルは
SKILL.mdを含むディレクトリです。エージェントは単一の Markdown ファイルです。 ソースパスはカスタマイズできます。デフォルトを想定せず、設定されたソースを使用してください。 - 追跡された
skills/<known-agent>/<skill-path>/SKILL.mdのコピーは、リポジトリ/プレフィックス/サフィックスごとに1つの論理スキルを形成します。 merge/copy は正確なエージェントバリアント（エイリアスとアカウントのagent:ID を含む）を選択します。 認識には、異なる2つの正規エージェント下で同じサフィックスが必要です。 互換性のあるターゲットがフォルダを共有する場合、それらのエージェント ID の和集合が選択されます。ユニバーサル専用ターゲットはエージェントを推論しません。 ステータスは論理スキルと物理バリアントをカウントします。リストと同期操作は物理名を保持します。 明示的なターゲット/オーバーライドと物理フィルターは引き続き適用されます。 ディレクトリ全体のシンボリックリンクモードでは、すべてのバリアントが公開されます。詳細は sync.md を参照してください。 - エージェントにはネイティブエージェントターゲットを使用してください。追加機能（extras）は、任意のファイルリソース、またはフラット化/コンテンツ変換が必要な場合に使用します。
extension:は拡張機能ターゲットでのみ機能します。 - 共有メモリノートは
memory拡張機能にあります。Markdown ノートと読み取りガイダンスを管理するにはextras memoryを使用します。wiki/architecture.mdのようなネストされたパスもサポートされています。 スコープ、バージョンチェック、エージェント設定については extras.md を参照してください。 セッションの振り返りや、保存されたノートに基づく Dreaming については memory-review.md を参照してください。 ホストエージェントがレビューを実行します。Skillshare はエージェントを起動したりスケジュールしたりしません。 - MCP は独自の受信ターゲットとソース定義を使用します。MCP 設定を編集したりネイティブ設定をインポートする前に mcp.md を読んでください。
そのエージェントノートでは、Claude Code、Codex、OpenCode、Pi に固有の内容（スコープとファイル、名前と拒否される資格情報、Pi の組み込み MCP と
piOptions、OMP のネイティブ MCP と保持される有効化/無効化リスト、ポータブルtoolsポリシー、 Pi 設定の 0.22 からのアップグレード、1つのプロジェクトでグローバルサーバーを無効にする方法、1つの設定から多数のフォルダを管理するmcp.projects、同期されたスキルフォルダにアクセスできないエージェントのためのmcp serve）について説明しています。 - プラグインはネイティブコンポーネントをまとめて保持します。プラグインのインストール、インポート、同期選択、更新、および Claude、Codex、Cursor、Antigravity、Pi、OMP、OpenCode 間のネイティブ互換性の制限（pi.dev の Pi パッケージ、 OMP マーケットプレイスプラグイン、スタンドアロン拡張機能の選択を含む）については plugins.md を読んでください。
- フックは各エージェントのネイティブイベントマップまたは拡張機能/プラグインコードを保持します。 インポート、同期、または復元の前に hooks.md を読んでください。
実行ルール
- 非対話型入力を選択してください。 特定のコマンドでサポートされている名前と選択フラグを指定してください。
プレーンな出力には
--no-tui、サポートされている場合は--jsonを使用してください。 プロンプトを避けるためだけに--forceを追加しないでください。競合を上書きしたり、監査を無効にしたりする可能性があります。 - プレビューと書き込みは分けてください。 サポートされている場合は
--dry-runを使用してください。スキルやエージェントを変更した後は、意図したリソースとスコープを同期してください。MCP とフックの変更は、--syncが指定されない限りソースのみを保存します。sync --allには追加機能、MCP、フックも含まれますが、プラグインは除外されます。 - 監査ブロックを検査してください。 オーバーライドを選択する前に結果を確認してください。
install --jsonは上書きを許可し、スキル/エージェントフィルターが指定されていない場合はすべてを選択しますが、監査ゲートは保持されます。単なる出力形式ではありません。自動化に使用する前に install.md と audit.md を読んでください。 - 適切な復元メカニズムを使用してください。 アンインストールされたスキルはゴミ箱に移動されます。ネイティブ MCP エントリは MCP バックアップを使用します。CLI アンインストールの代わりにファイルシステムの削除を使用しないでください。
- 資格情報を MCP 定義に含めないでください。
{fromEnv: VARIABLE}参照を使用してください。 設定の管理には、シークレットの解決、OAuth 資格情報のコピー、サーバーの起動、ツールの調査は必要ありません。 - 操作スコープを尊重してください。 ローカル設定の作業は、コミット、プッシュ、公開の許可を意味するものではありません。これらのコマンドは、ユーザーのリクエストに含まれている場合にのみ実行してください。
一般的なワークフロー
検査と診断
skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json
doctor はエラーを見つけると終了コード 1 を返します。監査は --format json を使用します。JSON フラグと TUI の利用可能性はコマンドによって異なります。同等性を想定せず、関連するリファレンスを参照してください。
上流リポジトリの追跡または選択したスキルのインストール
インストールする前にリソースとスコープを選択してください。ユーザー全体のリソースには -g、このプロジェクトには -p を使用してください。プレビュー、適用、更新、同期の全体でそのスコープを維持してください。
| 意図 | コマンド |
|---|---|
| 上流のスキルコレクションを1つの Git チェックアウトとして維持する | skillshare install owner/repo --track --name team -g |
| 名前付きスキルのみをソースメタデータと共にインストールする | skillshare install owner/repo -s pdf,commit -g |
| 発見されたすべてのスキルを個別にインストールする | skillshare install owner/repo --all -g |
| フック/MCP を含む完全なネイティブプラグインを管理する | plugin discover と plugin add を使用（以下参照） |
スコープ付きプレビュー → 適用 → 更新 → 同期ワークフローについては、install.md を読んでください。これには、最新の上流ブランチの追跡、拒否されるフラグの組み合わせ、ターゲットフィルターが含まれます。
プロジェクトのセットアップには init -p を使用し、その後 install -p と sync -p を実行します。設定されたリモート依存関係を install でソースなしで再水和します。完全なフラグの詳細とエージェントについては、install.md と sync.md を読んでください。
ローカルスキルチェックアウトをその場で使用するには、skillshare link <path> --enable を実行し、その後 sync を実行します。skillshare unlink <name> はリンクのみを削除します。このようなリンクがどのように追跡されるかについては、TROUBLESHOOTING.md を読んでください。
無効化または削除
skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync
この例のシーケンス全体ではなく、要求された操作を実行してください。グロブパターンを引用符で囲み、Skillshare が変更を受け取らないようにします。無効化は無視ルールを使用します。アンインストールはゴミ箱を使用します。
スキルをフォルダに移動する
skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync
インストール済みのスキルには mv の代わりに move を使用してください。インストールレコードが保持されるため、再度ダウンロードされることはありません。同期は行われません。その後 sync を実行してください。拒否されるケースとプロジェクトモードについては install.md を読んでください。
グローバル設定からのプロジェクトフォルダ
skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json
project は常にグローバル設定を使用します。リポジトリ内でも同様です。-p は受け付けません。
新しいプロジェクトは config.yaml に保存されるか、--machine-local または projects_storage: machine-local（--shared は設定を上書きします）を使用してこのマシン上にのみ保存されます。localize と share はプロジェクトを2つの間で移動します。config.yaml プロジェクトのローカルコピーを削除すると、--shared が指定されない限り config.yaml のバージョンが保持されます。編集フィルターはリストを置き換えます。削除はスキルを切り離し、エージェントファイルを保持します。JSON 削除には、プレビュー中でない限り --yes が必要です。保存後の同期失敗、再試行、部分的な削除結果については targets.md を読んでください。
MCP 設定
skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp
--target は単一で、繰り返し指定できます。プレビューでは変更は適用されません。修正、編集、インポート競合、資格情報、バックアップ、人間が操作する TUI コマンドについては mcp.md を読んでください。
完全なプラグイン
完全なネイティブパッケージには plugin discover と plugin add を使用します。plugin import は既存のネイティブインストールを採用します。要求された操作のみを実行してください。変更を適用する前に plugins.md を読んでください。スコープ付き上流ワークフロー、サポートされるターゲット、ソース参照ルールについて説明しています。
plugin check/update は上流の変更を処理します。sync plugins はターゲット選択を調整します。プラグインは sync --all から除外されます。
スキルハブ
skillshare hub add https://example.com/hub.json # ハブソースを保存
skillshare hub add https://example.com/hub.json --label my-hub # カスタムラベル付き
skillshare hub add [email protected]:team/skills.git --label ghe # SSH/プライベート/GHE ハブソース
skillshare hub list # 保存されたハブを一覧表示
skillshare hub default my-hub # デフォルトハブを設定
skillshare hub remove my-hub # ハブを削除
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit # ハブインデックスを構築
アクティブな follow_source_links 設定は、hub index（--source を含む）、組み込みのダッシュボード検索、およびハブドラフト候補にも適用されます。
リファレンス
コマンドフラグ、例、および制限については、対応するファイルを読んでください。単一のタスクですべてのリファレンスを読み込まないでください。
| トピック | ファイル |
|---|---|
| ネイティブエージェント、選択、無視ルール、復元 | native-agents.md |
| MCP 設定、インポート、TUI、復元 | mcp.md |
| ネイティブフック、コードバインディング、スコープ、復元 | hooks.md |
| 完全なプラグイン、ネイティブライフサイクル、同期選択 | plugins.md |
| Init フラグ | init.md |
| Sync/collect/commit/push/pull | sync.md |
| Install/update/uninstall/move/new | install.md |
| Status/diff/list/search/check | status.md |
| セキュリティ監査 | audit.md |
| インストール前の信頼できないスキルのレビュー | audit-review.md |
| ゴミ箱 | trash.md |
| 操作ログ | log.md |
| ターゲット | targets.md |
| 追加機能（ルール/コマンド/プロンプト） | extras.md |
| セッションの振り返りと保存されたノートの Dreaming | memory-review.md |
| バックアップ/復元 | backup.md |
| トラブルシューティング | TROUBLESHOOTING.md |