Community研究&データ分析github.com

maojiebc/majia-Popskill

Claude Code / Codex 向けローカルAI機能管理ツール:シンボリックリンクマウント、ソースセット、コンテンツハッシュ更新でスキルを一元管理

majia-Popskill とは?

Popskillは、Claude CodeやCodexなどのAIエージェント向けに、ローカル環境でスキル(カスタム指示やプラグイン)を一元管理するためのツールです。シンボリックリンクを用いたスキルのマウント、ソースコードのバージョン管理に適した「ソースセット」の構成、そしてコンテンツのハッシュ値に基づく差分更新といった機能を提供します。これにより、複数のスキルファイルを手動で管理する手間を省き、AIエージェントの動作環境を一貫して保つことができます。主にClaude CodeとCodexプラットフォームをサポートし、設定は一つのテーブル(設定ファイル)で完結するため、スキルの追加・削除・更新が容易です。開発者やパワーユーザーがAIエージェントの振る舞いを細かく制御したい場合に有用で、Gitなどのバージョン管理システムとの親和性も高い設計となっています。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add maojiebc/majia-Popskill

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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

関連スキル