skillshare

Skillshare CLI

Skillshare を使ってソースを管理し、リソースを設定済みのターゲットに配布します。 要求された操作に関連するリファレンスだけを読んでください。ルーティング表は以下のとおりです。 インストール済みのバージョンがこれらの例と異なる場合は、skillshare <command> --help を確認してください。

スコープとリソースの選択

• グローバル設定：~/.config/skillshare/config.yaml。プロジェクト設定：.skillshare/config.yaml または skillshare/config.yaml。両方ある場合は、隠し設定が優先されます。場所が重要な場合は、自動検出に頼らず、明示的に -g または -p を使用してください。
• スキルは SKILL.md を含むディレクトリで、エージェントは単一の Markdown ファイルです。 ソースパスはカスタマイズできます。デフォルトを想定せず、設定済みのソースを使用してください。
• エージェントにはネイティブのエージェントターゲットを使用してください。任意のファイルリソースや、 フラット化／コンテンツ変換が必要な場合は extras を使用してください。extension: が機能するのは extras ターゲットのみです。
• 共有メモリのメモは memory extra に保存されます。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 ポリシー、0.22 からの Pi 設定のアップグレード、1 つのプロジェクトでグローバルサーバーを無効にする方法、1 つの設定から複数のフォルダーを指定する mcp.projects、同期済みのスキルフォルダーにアクセスできないエージェント向けの mcp serve。
• プラグインでは、ネイティブコンポーネントがまとめて保持されます。Claude、Codex、Cursor、Antigravity、Pi、OMP、OpenCode におけるインストール、インポート、同期対象の選択、更新、ネイティブ互換性の制限については、plugins.md を読んでください。Pi 向けの pi.dev パッケージ、OMP マーケットプレースのプラグイン、単体の拡張機能の選択も含まれます。
• フックは、各エージェントのネイティブなイベントマップ、または拡張機能／プラグインのコードを保持します。インポート、同期、復旧の前に hooks.md を読んでください。

実行ルール

1. 対話なしで入力を指定します。 各コマンドがサポートする名前と選択フラグを指定してください。プレーンな出力には --no-tui を、サポートされている場合は --json を使用してください。 プロンプトを避けるためだけに --force を追加しないでください。競合を上書きしたり、監査を無効化したりする可能性があります。
2. プレビューと書き込みを分けます。 サポートされている場合は --dry-run を使用してください。スキルまたはエージェントを変更した後は、対象のリソースとスコープを指定して同期してください。MCP とフックの変更は --sync を指定しない限りソースのみを保存します。sync --all は extras、MCP、フックも含みますが、プラグインは含みません。
3. 監査ブロックを確認します。 上書きを選ぶ前に、検出結果を確認してください。install --json は上書きを許可し、スキル／エージェントのフィルターが指定されていない場合はすべてを選択しますが、監査ゲートは維持されます。単なる出力形式ではありません。自動化で使用する前に、install.md と audit.md を読んでください。
4. 適切な復旧手段を使います。 アンインストールされたスキルはゴミ箱に移動します。ネイティブの MCP エントリには MCP バックアップを使用してください。CLI のアンインストールの代わりに、ファイルシステムから削除しないでください。
5. 認証情報を MCP 定義に含めないでください。 {fromEnv: VARIABLE} 参照を使用してください。設定の管理には、シークレットの解決、OAuth 認証情報のコピー、サーバーの起動、ツールのプローブは必要ありません。
6. 操作のスコープを守ります。 ローカルの設定作業が、コミット、プッシュ、公開の許可を意味するわけではありません。ユーザーの依頼に含まれている場合に、それらのコマンドを実行してください。

一般的なワークフロー

調査と診断

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 に変更されずに渡るよう、グロブパターンは引用符で囲んでください。無効化には ignore ルールを使用し、アンインストールではゴミ箱を使用します。

スキルをフォルダーに移動する

skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync

インストール済みのスキルには、mv ではなく move を使用してください。インストール記録が保持されるため、再ダウンロードされません。同期は行われないため、その後 sync を実行してください。拒否条件とプロジェクトモードについては、install.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          # Save a hub source
skillshare hub add https://example.com/hub.json --label my-hub  # With custom label
skillshare hub add [email protected]:team/skills.git --label ghe  # SSH/private/GHE hub source
skillshare hub list                                      # List saved hubs
skillshare hub default my-hub                            # Set default hub
skillshare hub remove my-hub                             # Remove a hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Build hub index

有効な follow_source_links 設定は、hub index（--source を含む）、組み込みのダッシュボード検索、Hub のドラフト候補にも適用されます。

参考資料

コマンドのフラグ、使用例、制限事項については、該当するファイルをお読みください。1つのタスクですべての参考資料を読み込まないでください。

トピック	ファイル
ネイティブエージェント、選択、無視ルール、復旧	native-agents.md
MCP の設定、インポート、TUI、復旧	mcp.md
ネイティブフック、コードバインディング、スコープ、復旧	hooks.md
完全なプラグイン、ネイティブライフサイクル、同期対象の選択	plugins.md
Init のフラグ	init.md
同期／収集／コミット／プッシュ／プル	sync.md
インストール／更新／アンインストール／移動／新規作成	install.md
ステータス／差分／一覧／検索／チェック	status.md
セキュリティ監査	audit.md
ゴミ箱	trash.md
操作ログ	log.md
ターゲット	targets.md
追加要素（ルール／コマンド／プロンプト）	extras.md
セッションの振り返りと、保存済みメモを使った Dreaming	memory-review.md
バックアップ／復元	backup.md
トラブルシューティング	TROUBLESHOOTING.md