メインコンテンツまでスキップ

理解する

これらの概念を理解することで、skillshare を最大限に活用できます。

何を理解したいですか?​

質問参照先
skillshare はどのように Skill を移動させるのですか?Source & Targets
merge と symlink の違いは何ですか?Sync Modes
組織全体で Skill を共有するにはどうすればいいですか?Tracked Repositories
SKILL.md の中身は何ですか?Skill Format
プロジェクトレベルの Skill はどのように機能しますか?Project Skills

概要​

主要な概念​

概念内容詳細
Source & Targets単一の信頼できる情報源から複数の配布先へ→ Source & Targets
Sync ModesMerge、copy、symlink — ファイルのリンク方法→ Sync Modes
Tracked Repos--track でインストールされた Git リポジトリ→ Tracked Repositories
Skill FormatSKILL.md の構造とメタデータ→ Skill Format
Project Skillsリポジトリに紐づくプロジェクトレベルの Skill→ Project Skills
Organization Skillstracked repositories による組織全体の Skill→ Organization-Wide Skills

クイックサマリー​

Source & Targets​

  • Source: ~/.config/skillshare/skills/ — Skill を編集する場所
  • Targets: AI CLI の Skill ディレクトリ — symlink 経由で Skill が配置される場所

Sync Modes​

  • Merge(デフォルト): 各 Skill が個別に symlink され、ローカル Skill は保持される
  • Copy: 各 Skill が個別にコピーされ、ローカル Skill は保持される
  • Symlink: ディレクトリ全体が 1 つの symlink になる

Tracked Repos​

  • --track でインストールされた Git リポジトリ
  • _ プレフィックスが付く(例: _team-skills/)
  • skillshare update <name> で更新される

Skill Format​

  • YAML frontmatter を持つ SKILL.md
  • 必須: name フィールド
  • オプション: description、カスタムメタデータ

Project Skills​

  • 単一リポジトリに紐づく Skill(.skillshare/skills/)
  • git 経由でチームと共有 — .skillshare/ が存在すると自動検出される
  • ターゲットごとに sync mode を設定可能(デフォルトは merge、symlink も選択可能)

Organization Skills​

  • tracked repositories(--track)経由ですべてのプロジェクトで共有
  • 一度インストールすれば skillshare update --all で更新
  • Project Skills を補完する — organization は標準化のため、project はリポジトリ固有のコンテキストのため

設計思想​

skillshare の設計判断についての詳しい説明です。

トピック概要
Why Local-First単一バイナリ、依存関係ゼロ、デフォルトでオフライン動作
Security-First15 以上の監査パターン、サプライチェーンの脅威モデル
Sync Modes Deep DiveMerge と symlink のトレードオフを詳しく解説
Comparisonskillshare と他ツールの比較
Skill Design効果的な Skill を書くためのガイドライン