レシピ: Project Mode ワークフロー
コードベースと共に移動するプロジェクトスコープの Skill を管理する。
シナリオ
特定の Skill をプロジェクトリポジトリにコミットしておきたい理由は次の通りです。
- すべてのコントリビューターが同じ AI 指示を得られる
- Skill がコードと一緒にバージョン管理される
- リポジトリを clone する以外の手動セットアップが不要になる
解決策
ステップ 1: Project mode を初期化する
cd your-project
skillshare init -p
これによりプロジェクトのルートに .skillshare/config.yaml が作成されます。
ステップ 2: プロジェクトスコープの Skill をインストールする
skillshare install anthropics/courses/prompt-eng -p
skillshare install your-org/team-skills --skill code-review -p
Skill は .skillshare/skills/ に配置されます。
ステップ 3: プロジェクトの Target に Sync する
skillshare sync -p
これにより .skillshare/skills/ からプロジェクトレベルの Target ディレクトリ（例: .claude/skills/、
.cursor/skills/）へのシンボリックリンクが作成されます。
ステップ 4: バージョン管理にコミットする
git add .skillshare/
git commit -m "Add project skills"
ステップ 5: チームメンバーのセットアップ
チームメンバーがリポジトリを clone すると:
git clone your-org/your-project
cd your-project
skillshare sync -p
1つのコマンドで、すべてのプロジェクトの Skill が彼らのローカルの AI ツールに Sync されます。
確認
- プロジェクトのルートに
.skillshare/config.yamlが存在する .skillshare/skills/にインストールされた Skill が含まれるskillshare list -pがプロジェクトの Skill を表示するsync -pの後、Target ディレクトリにシンボリックリンクが含まれる
バリエーション
- Dev Container の自動 Sync:
.devcontainer/devcontainer.jsonのpostCreateCommandにskillshare sync -pを追加する - 混合モード: 個人の好みには Global の Skill を、チーム標準にはプロジェクトの Skill を使う
- CI 検証: プロジェクトの Skill を検証するため、CI パイプラインに
skillshare audit -pを追加する