0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

エージェントスキルを管理する gh skill

0
Posted at

2026年4月16日にGitHubで発表された AIエージェント向けスキルの「パッケージマネージャー」
Claude Code / GitHub Copilot / Gemini CLIなど、各AIエージェントごとに拡張スキルをインストールなどしていたものをGitHub CLIから管理(インストール、更新など)できるようになるとのことです。


主な特徴

  • 複数のエージェント対応: GitHub Copilotだけでなく、Claude Code、Cursor、Codex、Gemini CLIなど、現行の主要なエージェントホストのディレクトリ構成を透過的に扱い、自動で適切な場所にスキルを配置してくれる。
  • アップデートやバージョン固定もサポート: 単にファイルをダウンロードするだけでなく、インストール時にGit tree SHAなどの追跡用メタデータをSKILL.mdのフロントマターに記録します。これにより、改ざん防止や正確な差分検知(update)が可能になり、--pinによるバージョン固定もサポートされているとの。
  • 公開フローの自動検証: 自身で作成したスキルを公開(publish)する際、agentskills.ioのオープンな仕様に準拠しているか自動で検証されます。さらに、GitHubのセキュリティ設定(タグ保護やImmutable releasesなど)の有効化も促されるため、安全なスキル配布が担保される。

コマンド

コマンド 役割 実行される処理の概要
gh skill search 検索 GitHub Code Searchを利用し、公開リポジトリ内のSKILL.mdを横断検索します。
gh skill preview 事前確認 インストール前にファイル構成や内容をターミナルで対話的に確認し、安全性をチェックします。
gh skill install 導入 対象ホスト(--agent)やスコープ(project/user)に合わせてディレクトリへ配置し、追跡メタデータを付与します。
gh skill update 更新管理 Git tree SHAを比較して差分を検知し、最新状態へ同期します(特定バージョンへのピン留めも可能)。
gh skill publish 検証・公開 構成の整合性をチェックした上で、GitHubリポジトリのリリース機能を使って安全にパッケージを公開します。

現在はパブリックプレビューという位置づけのため、業務に本格導入する際は今後の仕様変更に留意する必要がありますが、これまでリポジトリごとに散在していた「AIへの指示書やスクリプト」をエコシステムとして共有できる画期的な仕組みです。

インストール

Mac環境で gh skill を使い始めるためのインストール手順。
2026年4月リリースの機能であるため、GitHub CLI自体のバージョンアップが必要。


1. GitHub CLI のインストールと更新

ご利用状況に合わせて変えてください。

  1. Homebrewとghを最新にする
    ターミナルを開き、以下のコマンドを実行します。
    brew update && brew upgrade gh
    
  2. バージョンの確認
    gh skill を利用するには、バージョン 2.90.0 以降が必要です。
    gh --version
    

    注意: ここで 2.90.0 未満が表示される場合は、パスが古いか更新が反映されていない可能性があります。


2. GitHub への認証

まだ gh コマンド自体を使ったことがない場合は、まずログインが必要です。

gh auth login
  • 案内を読み、ブラウザ経由で認証を完了させてください。

3. 最初のスキルをインストールしてみる

  1. gh skill search ◯◯ で検索できます。
  2. 矢印キーで移動、スペースキーで選択、<右>ですべて選択、<左>ですべて選択解除、テキストを入力してフィルタリング
  3. Enter キーを押すと、選択したスキルのインストールが開始されます。→ 次のページ
  4. 何も選択していない場合は、インストールされずに終わります。
# 例: Python関連のスキルを探してインストール
gh skill search python

↓ 検索結果 : リストから目的のものを Space で選び、 Enter を押します。

✓ Showing 3 skills matching "python"

? Select skills to install (press Enter to skip):  [Use arrows to move, space to select, <right> to all, <left> to none, type to filter]
  [ ]  python  Mindrally/skills  ★ 84
       Expert in Python development with best practices across web, data ...
  [ ]  python  Senpi-ai/senpi-skills  ★ 75
       PYTHON v1.0 — The Patience Hunter. The fleet's first multi-day ho... 
  [ ]  python  video-db/skills  ★ 74
       See, Understand, Act on video and audio. See- ingest from local fi...

↓ インストールするターゲットを聞かれます。

? Select target agent:  [Use arrows to move, type to filter]
> GitHub Copilot
  Claude Code
  Cursor
  Codex
  Gemini CLI
  Antigravity

↓ カレントディレクトリ or グローバル 、どちらにインストールするか聞かれます。

> Project: install in current repository (recommended)
  Global: install in home directory (available everywhere)

4. インストール済みのスキルを確認する(Mac)

Macの場合、グローバル(Userスコープ)でインストールしたスキルは以下の場所に格納されます。

  • GitHub Copilot用: ~/.copilot/skills/
  • Gemini CLI用: ~/.gemini/skills/
  • Claude Code用: ~/.claude/skills/

現在(2026年4月時点)のパブリックプレビュー版の gh skill には、インストール済みのスキルを一覧表示する専用のコマンド(例: gh skill list のようなもの)はまだ用意されてないため、現状は保存先のディレクトリを直接確認する必要がある。

プロジェクト単位(projectスコープ) 対象のディレクトリで以下を実行

# 共通ディレクトリ(Copilot, Cursor, Gemini CLIなど)向け
ls -la .agents/skills

# Claude Code向けの場合
ls -la .claude/skills

グローバル(userスコープ) ホームディレクトリ配下にある、各エージェントの隠しフォルダを確認

# GitHub Copilot 向け
ls -la ~/.copilot/skills

# Gemini CLI 向け
ls -la ~/.gemini/skills

# Cursor 向け
ls -la ~/.cursor/skills

スキルの更新

更新状況の確認
実際の更新は行わず、「どのスキルに更新が来ているか」の確認だけを行う

gh skill update --dry-run

更新

対話モード(インタラクティブ)で実行されます。
更新可能なスキルが見つかった場合、ターミナル上で「更新しますか?」と確認してくれるため、普段の安全なアップデートに最適。

gh skill update

全て更新
確認プロンプトを出さずに、更新可能なすべてのスキルを一気に最新化します。

gh skill update --all

個別に更新
特定のスキルの新しいバージョンが出たことだけを知っていて、それだけを手早く更新したい時に便利です。

gh skill update [スキル名] (例: gh skill update git-commit)
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?