Communitygithub.com

xFurti/skillctl

エージェントスキル向けユニバーサルパッケージマネージャーCLI — マニフェスト、ロックファイル、マルチエージェント同期(Cursor, Claude, Codex, Gemini)。Node ≥22.13。

skillctl とは?

skillctl は、Cursor、Claude、Codex、Gemini など複数のAIエージェント向けスキルを一元管理するためのCLIツールです。スキルのインストール、同期、更新、監査を提供し、マニフェスト(agent-skills.json)とロックファイル(agent-skills.lock)を用いてチームでの再現性を確保します。Node.js 22.13以上が必要で、GitHub、npm、ローカルファイル、skills.sh などの様々なスキルソースをサポートします。また、既存のエージェントディレクトリや npx ベースのスキルからの移行を容易にする `import` コマンドを備えています。

対応✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add xFurti/skillctl

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

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

ドキュメント

skillctl は何をしますか?

Agent Skills を skillctl CLI で管理するための運用プレイブック。実際のコマンドを実行すること。出力のシミュレーションや、SKILL.md ファイルをエージェントディレクトリ間で手動コピーしてはいけません。

ゴールデンルール

  1. 単一の正規ストア — スキルは ~/.skillctl/skills/<name>/ に配置され、エージェントは sync によってシンボリックリンクを受け取ります。
  2. マニフェスト + ロックをコミットする — チームの再現性のために agent-skills.json と agent-skills.lock を git で追跡します。
  3. ポータブル指定子のみ使用する — file:./<path>、local:imported/<name>、github:、npm:、skills.sh/ を使用し、絶対パスのホームディレクトリをコミットしてはいけません。
  4. 同期前にインストールする — install でストアを実体化し、sync はエージェントの再リンクのみ行います。
  5. 変更後に検証する — skillctl doctor(および CI では skillctl audit)を実行します。
  6. 手動コピーよりインポートを優先する — スキルフォルダを複製する代わりに import from-project または import from-npx を使用します。

決定木

状況コマンド
新規プロジェクト、マニフェストなしskillctl init または skillctl init --with-skill
リモートまたはローカルのスキルを追加skillctl add <specifier> その後 skillctl install
スキルが既に .claude/skills、.codex/skills 等にあるskillctl import from-project
npx skills からの移行skillctl import from-npx
再リンクのみ(ロックは変更なし)skillctl sync
アップストリームから再取得skillctl update または skillctl update <name>
CI での再現可能なインストールskillctl install --frozen その後 skillctl audit --strict
ロック内の非ポータブルパスskillctl install で書き換え。skillctl doctor の警告を確認

クイックレシピ

# ブートストラップ
skillctl init --with-skill
skillctl add github:vercel-labs/agent-skills#web-design-guidelines
skillctl install

# プロジェクトローカルスキル
skillctl add file:./my-skill
skillctl install
skillctl sync

# 既存のエージェントディレクトリをインポート
skillctl import from-project --dry-run
skillctl import from-project

# 確認
skillctl list
skillctl doctor
skillctl audit --json

add file:./my-skill + install 後の期待結果: マニフェスト指定子 file:./my-skill、ロック canonicalPath は ~/.skillctl/skills/my-skill のようになります。

ポータビリティ (0.3.1+)

  • ポータブル: file:./rel、local:imported/<name>、リモート指定子、canonicalPath: ~/.skillctl/skills/<name>。
  • 非ポータブル: 絶対パスの file:/Users/...、local:/abs/path、別のマシンからの絶対 canonicalPath。
  • doctor が非ポータブルパスに関する警告を出した場合、skillctl install を実行してマニフェストからロックを書き換えてください。

障害モード

症状アクション
canonical path missingskillctl install
整合性不一致skillctl update <name> または skillctl install
シンボリックリンク失敗(Windows)doctor が通知。defaultMode: copy で設定
エージェントがリンクされていないskillctl sync。~/.skillctl/config.json でエージェントを有効化
Frozen install failedストアの同期が取れていない。--frozen なしで install を実行

参考

関連スキル