2026年5月29日

gh skillを使ってAgent Skillsの導入を行う

X-tech推進本部倉原

本記事では、GitHub公式CLIであるgh skillを使って、Agent Skillsを安全かつ効率的に検索・確認・導入する方法を紹介します。

エージェントAIの活用が広がる中で、「Agent Skills（エージェントスキル）」が重要になってきています。

Agent Skillsとは、AIに特定のタスクの手順や判断基準を教えるためのパッケージです。従来のように毎回プロンプトを書くのではなく、一度定義したスキルを再利用することで、より一貫したアウトプットが得られます。

重要なのは、このスキルは自分で作るだけでなく、配布されているものを利用できるという点です。実際、Agent Skillsを集約したポータルもいくつか登場しており、数多くのスキルを検索して利用できるようになっています。

一方で、品質の低いスキルや悪意のあるスキルを導入すると、意図しない挙動やセキュリティリスクにつながる可能性があります。

このため、Agent Skillsは「探して使う」だけでなく、どのスキルをどのように管理・運用するかも重要になります。

こうした背景から、スキルをパッケージとして扱うためのツールも登場しています。例えば、Vercelが作成しているskillsや、今回紹介するgh skillなどは、スキルの検索・インストール・更新をCLIから一元管理できる仕組みです。

この中でもGitHub公式のgh skillの概要と使い方を紹介します。

gh skillの使い方

gh skillを使うためには、GitHub CLI v2.90.0以上が必要になります。gh skillの公式サイトでは、5つの主要な機能が紹介されています。

gh skillを使ってスキルを検索して、プレビューを行い、インストールするまでを行ってみます。

スキルを検索にはgh skill search <query> [flags]として実行します。

例えばgh skill figmaと実行すると、次のように「figma」にヒットするスキルの一覧がターミナルに表示されます。

スキルの内容をプレビューするにはgh skill preview <repository[<skill>] [flags]として実行します。

今回はFigma MCPのスキル「figma/mcp-server-guide figma-code-connect」をプレビューしてみます。

gh skill preview figma/mcp-server-guide figma-code-connectを実行し、SKILL.md を選択すると次のような結果がターミナルに表示されました。

※ 詳細は割愛しております。

previewを使うことで、インストール前にスキルのプレビューを行えます。

スキルをインストールするにはgh skill install <repository[<skill[@version]>] [flags]として実行します。

ここでは「figma-code-connect」をインストールしてみます。

gh skill install figma/mcp-server-guide figma-code-connectを実行すると、次のようにAIエディタの一覧が表示されます。

インストール先をCursorにし、プロジェクト内にインストールするように設定しインストールを行います。

インストールが完了すると、以下のキャプチャのようにスキルが設定されます。

これでスキルを使えるようになります。

企業やチームでAgent Skillsを利用する場合は、インストール前のプレビュー確認や、利用可能なスキルの選定ルールを定めておくことが重要です。

gh skillを使うことで、スキルをコードと同様にレビュー・管理できるため、社内ガイドラインと組み合わせることで安全性と再現性を高めることができます。

Agent Skillsは作るだけでなく、検索して活用することが重要になります。
その一方で品質や安全性に問題があるスキルをインストールしないように気を付ける必要があります。

gh skillを活用することで、Agent Skillsの導入・管理・検証を効率的に行えるようになります。