Skip to content

README.ja.md

Latest commit

 

History

History
109 lines (81 loc) · 3.14 KB

README.ja.md

File metadata and controls

109 lines (81 loc) · 3.14 KB

skillpkg

English | 中文 | 日本語 | Français

Claude Code スキル向けの TUI パッケージマネージャー。

機能

  • レジストリからスキルを閲覧・インストール
  • インストール済みスキルパッケージの管理
  • バージョン（git コミット）の切り替え
  • プロジェクト単位のインストール（.claude/skills/ にインストール）

インストール

cargo install --git https://github.com/mofa-org/skillpkg

またはソースからビルド：

git clone https://github.com/mofa-org/skillpkg
cd skillpkg
cargo build --release

使い方

プロジェクトディレクトリで skillpkg を実行：

cd /path/to/your-project
skillpkg

キーボード操作

メインメニュー：

  • ↑/↓ または j/k - 移動
  • Enter - 選択
  • q または Ctrl+C - 終了

レジストリ閲覧：

  • ↑/↓ - パッケージ移動
  • Enter - 詳細表示
  • i - インストール
  • q - 戻る

インストール済みパッケージ：

  • ↑/↓ - 移動
  • Enter - 詳細表示
  • u - 更新
  • d - アンインストール
  • q - 戻る

バージョン選択：

  • ↑/↓ - コミット移動
  • Enter - 選択したバージョンに切り替え
  • q - 戻る

パッケージマニフェスト形式

パッケージは packages/ ディレクトリ内の JSON ファイルで定義します：

{
  "name": "package-name",
  "description": "スキルパッケージの説明",
  "source": "https://github.com/owner/repo/tree/branch/path/to/skills",
  "auto_prefix": true
}
  • name: パッケージ識別子（auto_prefix が true のときプレフィックスとして使用）
  • description: 人が読める説明
  • source: skills のルートディレクトリを指す GitHub URL（リポジトリのルート、または https://github.com/ZhangHanDong/makepad-skills/tree/main/skills のようなサブディレクトリ。HTTPS URL 必須、SSH 不可）
  • auto_prefix: true の場合、インストールされた skill ディレクトリはパッケージ名でプレフィックスされる

貢献

新しいスキルパッケージを追加する場合は PR を提出してください。レビューとインデックスのため、新規スキルは PR 経由のみ受け付けます。

  1. このリポジトリを Fork してブランチを作成。
  2. packages/ に新しい JSON マニフェストファイルを追加（name は一意、source は正確、description は明確）。
  3. マニフェストが上記形式に沿っていることを確認。
  4. 簡単な概要を添えて PR を作成。

ローカル状態

skillpkg はインストール状態を .claude/skills/.installed.json に保存します：

{
  "packages": {
    "package-name": {
      "source": "https://github.com/...",
      "commit": "abc1234...",
      "auto_prefix": true,
      "installed_at": "2025-01-16T00:00:00Z",
      "skills": ["package-name-skill1", "package-name-skill2"]
    }
  }
}

ライセンス

Apache-2.0