● コミュニティ
mensfeld
⚡ 即起動
craftdesk
作者 mensfeld · mensfeld/craftdesk
Claude Code スキル用の npm — インストール、バージョン固定、ロックファイル、Claude Code / Cursor / Windsurf / Continue 間の同期、チェックサム検証、コレクション機能を備えています。
CraftDesk は AI 機能(スキル、エージェント、コマンド、フック、プラグイン)向けの CLI パッケージマネージャーです。GitHub URL や git リポジトリからインストールでき、モノレポのサブディレクトリ対応や再帰的な依存関係解決をサポートします。再現可能な環境のために craftdesk.json とロックファイルを生成します。インストール済みのクラフトを Claude Code、Cursor、Windsurf、Continue.dev 間で同期できます。埋め込み型(ローカル)スキルにも対応しており、プロジェクト固有のスキルをリポジトリ内に配置できます。
なぜ使うのか
主な機能
- GitHub URL または git リポジトリからインストール(URL 自動正規化)
- モノレポのサブディレクトリ+単一ファイル対応
- 再帰的な依存関係解決
- craftdesk.json + ロックファイルによる再現性の確保
- マルチエージェント同期: Claude Code, Cursor, Windsurf, Continue.dev
- チェックサム検証による整合性保証
- 埋め込み型(リポジトリローカル)スキル対応
- バンドルされたクラフトのコレクション機能
ライブデモ
実際の動作
craftdesk-skill.replay
▶ 準備完了
ユースケース
実用的な使い方: craftdesk
使うタイミング: チームメンバーがそれぞれ異なるスキルを選んでおり、全員を同じセットに揃えたい場合。
フロー
-
プロジェクトマニフェストを初期化する
craftdesk init — このリポジトリ用に craftdesk.json をセットアップ。✓ コピーしました
→ craftdesk.json が作成される
-
スキルを追加する
craftdesk add planning-with-files agent-skill-tdd swing-skills — バージョンを固定。✓ コピーしました
→ マニフェストが更新され、ロックファイルが書き込まれる
-
チームメンバーがインストールする
チームメイトがクローン後に craftdesk install を実行。✓ コピーしました
→ 同じスキルと同じバージョンがマシンにインストールされる
結果: AI 向けの package.json のような再現可能なスキル環境。
注意点
- 埋め込みスキルにシークレットを含めてコミットしてしまう — 埋め込みスキルに認証情報を含めない — 環境変数で管理すること
使うタイミング: Claude Code でスキルをインストールして、Cursor でも使いたい場合。
フロー
-
同期する
craftdesk sync — インストール済みの全クラフトを全エージェントで利用可能にする。✓ コピーしました
→ 各エージェントのインストールパスにファイルが配置される
-
検証する
craftdesk verify — 差異はないか?✓ コピーしました
→ 全エージェントでグリーン(正常)
結果: どのエージェントを開いても一貫したツール環境。
使うタイミング: 社内プロセス用のスキルを作成し、craftdesk add でインストール可能にしたい場合。
フロー
-
公開する
craftdesk publish — このクラフトをレジストリにプッシュ。✓ コピーしました
→ バージョン付きで公開される
結果: 通常のコード依存関係と同様にバージョン管理された社内クラフトライブラリ。
組み合わせ
他のMCPと組み合わせて10倍の力を
GitHub URL から直接クラフトをインストールする
craftdesk add https://github.com/org/skill✓ コピーしました
./skills/ 配下の埋め込みスキルが自動的に検出される
Create an embedded skill at ./skills/custom-review and run craftdesk sync.✓ コピーしました
コストと制限
運用コスト
- APIクォータ
- なし
- 呼び出しあたりのトークン
- 最小限 — CraftDesk は CLI 駆動のため
- 金額
- 無料
- ヒント
- ロックファイルを活用すること — インストールのたびに再解決するのを防げます
セキュリティ
権限、シークレット、影響範囲
認証情報の保管: プライベート公開時はレジストリトークンを環境変数に設定
データ送信先: インストール元の git ホストおよび設定済みレジストリへのみ送信
- CraftDesk は URL から任意のコードをインストールします — 不明なクラフトを追加する前に repo-forensics と組み合わせて検証してください。
トラブルシューティング
よくあるエラーと対処法
checksum mismatch でインストールが失敗する
アップストリームが変更された可能性があります。コミット SHA に固定するか、ロックファイルを意図的に更新してください
craftdesk sync で一つのエージェントが検出されない
エージェントのパスが存在し書き込み可能であることを確認してください。craftdesk config を参照
代替案
craftdesk 他との比較
| 代替案 | 代わりに使う場面 | トレードオフ |
| Manual git clone into skills dir | 単一マシンでチーム利用なしの場合 | バージョン固定なし、同期なし |
| gsd-skill-creator | スキルの管理ではなく、スキルの自動生成が必要な場合 | 解決する課題が異なる |