majia-Popskill は何をしますか?
ローカルAI機能管理ツール — Claude Code / Codex のスキルを一元管理:シンボリックリンクマウント、ソースセット、コンテンツハッシュ更新
このツールは、Claude CodeやCodexのようなAIエージェントが使用するスキル(カスタム指示や設定ファイル)をローカル環境で効率的に管理するために設計されています。
主な機能
- シンボリックリンクマウント: スキルファイルを任意の場所からエージェントの設定ディレクトリにシンボリックリンクでマウントします。
- ソースセット: スキルのソースコードをGitリポジトリなどでバージョン管理可能な形式で保持します。
- コンテンツハッシュ更新: ファイルの内容に基づくハッシュ値を利用して、変更があった場合のみスキルを更新します。
サポートプラットフォーム
- Claude Code
- Codex
使用方法
設定は一つのテーブル(例:skills.json や popskill.yaml)で管理します。以下は基本的な設定例です。
{
"skills": [
{
"name": "custom-prompt",
"source": "./my-skills/custom-prompt",
"target": "~/.claude/skills/custom-prompt.md",
"type": "symlink"
},
{
"name": "codex-wrapper",
"source": "./my-skills/codex-wrapper",
"target": "~/.codex/skills/codex-wrapper.md",
"type": "symlink"
}
]
}
インストール
npm install -g @maojiebc/majia-popskill
# または
pip install maojiebc-popskill
コマンドライン
popskill mount # 設定に基づいてスキルをマウント
popskill update # 変更があったスキルのみを更新
popskill list # 現在のスキル一覧を表示
popskill status # スキルの状態を確認
設定オプション
| オプション | 説明 | デフォルト値 |
|---|---|---|
--config | 設定ファイルのパス | ./popskill.json |
--verbose | 詳細なログを表示 | false |
--dry-run | 実際の変更を行わずに確認 | false |
ライセンス
MIT