【Github】GitHub Skills 〜 基本編 〜

◾️はじめに

https://dk521123.hatenablog.com/entry/2026/09/25/122553

の続き。

今回は、GitHub Skillsを作る上での基本事項をまとめる

基本的なことがわかった上で、以下の関連記事のようなツールを使うといいかも。

GitHub Skills 〜 copilot-plugin-skill 〜
https://dk521123.hatenablog.com/entry/2026/10/31/000303

目次

【1】定義ファイル:SKILL.md
【2】フロントマター(--- で囲まれた部分)
 1)description
【3】配置ルール(ディレクトリ構成)
【4】Tips
 1)段階的開示(Progressive Disclosure)に対応させる
 2)命令は能動態で具体的に書く

【1】定義ファイル:SKILL.md

---
name: skill-name
description: このスキルの目的と、どんな時に呼び出すべきかを簡潔に記載(AIが判断する基準になります)
---

# 概要
このスキルが何を行うものかを記載します。

# 前提条件
- 必要なツールやCLI、環境変数
- 前提となるファイル構成

# 実行手順
1. **ステップ1**: 具体的な指示
2. **ステップ2**: 具体的な指示

# 出力フォーマット
出力すべきファイルの形式や、テンプレートをここに記載します。

【2】フロントマター(--- で囲まれた部分)

* フロントマター(--- で囲まれた部分)は必須
parameters Explanations Memo
name (必須) スキルを識別する一意の名前名(小文字とハイフンを使用) ケバブケース my-awesome-skill 推奨
description (必須) スキルの内容と、AIがどのタイミングで使用すべきかを説明する重要なフィールド(最大1,024文字)
license (省略可能) このスキルに適用されるライセンスの説明。

1)description

[1] 発火の仕組み

* ユーザーの自然言語の指示やプロンプトの文脈から、
 AIが SKILL.md の description(説明文)を読み取って自動的に検出・起動
* GitHub CLIでは gh skill コマンドを使ってスキルのインストールや管理が可能

【3】配置ルール(ディレクトリ構成)

* プロジェクト単位で適用する場合は、
 必ず . github/skills/スキル名/SKILL.mdの階層に配置する必要がある
項目 保存場所
プロジェクト(ワークスペース)固有 .github/skills/
複数プロジェクトで共有する個人用 ~/.copilot/skills/

同梱リソース

指示だけでなく、
 + scripts/(スクリプト)
 + references/(参照ドキュメント)
 + assets/(テンプレート)
などをフォルダ単位でまとめて持たせることができる

ディレクトリ構成例

.github/skills/
└── my-skill/
    ├── SKILL.md       # メインの指示書
    ├── scripts/       # ヘルパースクリプト(自動化ツール)
    ├── references/    # 参照ドキュメント・API仕様書
    ├── examples/      # サンプルコード・実装例
    └── assets/        # テンプレート・アーキテクチャ図

【3】Tips

1)段階的開示(Progressive Disclosure)に対応させる

* AIのメモリ(コンテキスト窓)を節約するため、
 ファイルが巨大になりすぎないよう簡潔に手順をまとめる

2)命令は能動態で具体的に書く

* 「〜をチェックします」ではなく、
 「〇〇ファイルを開き、❌❌が含まれているか確認せよ」
 のように、AIへの明確なプロンプト(指示)として記述

関連記事

GitHub Skills 〜 入門編 〜
https://dk521123.hatenablog.com/entry/2026/09/25/122553
GitHub Skills 〜 スキル作成補助 〜
https://dk521123.hatenablog.com/entry/2026/10/30/131957
GitHub Skills 〜 copilot-plugin-skill 〜
https://dk521123.hatenablog.com/entry/2026/10/31/000303
Github ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2019/07/18/234652

【Github】GitHub Skills 〜 copilot-plugin-skill 〜

◾️はじめに

https://dk521123.hatenablog.com/entry/2026/10/30/131957

の続き。

今回は、その中で「copilot-plugin-skill」について取り上げる。

目次

【1】copilot-plugin-skill
【2】copilot-plugin-skillのセットアップ
 Step1: GitHub Copilot CLI のインストール
 Step2: copilot-plugin-skill のインストール
【3】copilot-plugin-skillを使ったSkill作成方法
 Step1: ターミナルで対象のリポジトリ(プロジェクト)に移動する
 Step2: Copilot CLI を起動する
 Step3: プロンプトを送信する
【4】作成したSkillを実行するには
 方法1:VS Code の GitHub Copilot Chat から呼び出す
 方法2:ターミナル(Copilot CLI)から呼び出す

【1】copilot-plugin-skill

GitHub Copilot CLIなどで、
プラグインやMCP(Model Context Protocol)ツールを
伴う拡張機能を開発するための開発キット的なスキル

https://github.com/htekdev/copilot-plugin-skill

【2】copilot-plugin-skillのセットアップ

Step1: GitHub Copilot CLI のインストール

https://docs.github.com/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli

# For MAC
$ brew install --cask copilot-cli

# --cask(Homebrew Cask) ... 
# macOSのGUIアプリケーションやフォント、プラグインを
# ターミナル(コマンドライン)から自動でインストール・管理できる
# Homebrewの拡張機能

Step2: copilot-plugin-skill のインストール

$ copilot plugin install htekdev/copilot-plugin-skill
Plugin "copilot-plugin-skill" installed successfully. Installed 1 skill.

Warning: Direct plugin installs (repos, URLs, local paths) are deprecated. Only plugin@marketplace installs will be supported in a future release.

【3】copilot-plugin-skillを使ったSkill作成方法

Step1: ターミナルで対象のリポジトリ(プロジェクト)に移動する

mkdir demo_skill

Step2: Copilot CLI を起動する

copilot

# 「このフォルダ内で Copilot がファイルを作成・編集したり、
# コマンドを実行したりしても良いですか?」
# というセキュリティの確認(信頼の確認)画面
#  => 1. Yes or 2. Yes, and remember this folder for future sessions を選択(今回は1)
Copilot can read files in this folder and, with your permission, edit them 
or run code and shell commands. It will remember your permissions for the 
rest of this session.
Do you trust the files in this folder?
❯ 1. Yes
  2. Yes, and remember this folder for future sessions
  3. No (Esc)

Step3: プロンプトを送信する

* 起動した対話画面で、以下のようなプロンプトを投げる
 => インストールした copilot-plugin-skill の知識を使って、
  雛形を一気に作ってくれる

例

ユーザーが指定したPythonライブラリを追加し、
既存の requirements.txt / constraints.txt / plugins.zip を連動して
更新・生成する新しいSkillを作成したいです。

このプロジェクト内に必要なファイル構成(SKILL.mdや設定ファイルなど)
の雛形を生成してください。

# 「作業を始める前に、関連するフォルダ(既存のスキル例など)が
# 存在するか確認するためのシェルコマンドを実行してよいか?」
# と許可を求めてきている画面
#  => 1. Yes を選択
Check target directory status
for d in demo_skill demo-hello-template demo-hello-world; do printf 
'\n[%s]\n' "$d"; git -C "$d" status --short --branch 2>/dev/null || 
true; done
Do you want to run this command?
❯ 1. Yes
  2. No, and tell Copilot what to do differently (Esc to stop)

# Skillを作成していいかのかの画面
#  => 1. Yes を選択
Do you want to create /Users/user/demo_skill/skills/pyt
hon-library-sync/SKILL.md?
❯ 1. Yes
  2. Yes, and don't ask again for file operations when in this directory 
(~/work/git)
  3. No, and tell Copilot what to do differently (Esc to stop)

# 生成した設定ファイル(skill-config.json)の構文(JSONのフォーマット)
# にエラーがないか検証し、
# 今回の一連の処理で、実際にどんなファイル構造が作られたかを
# 一覧表示して画面で確認
# => 1. Yes を選択
Validate config and list generated files
python3 -m json.tool demo_skill/skills/python-library-sync/skill-
config.json >/dev/null && find demo_skill -maxdepth 4 -type f -print
Do you want to run this command?
❯ 1. Yes
  2. No, and tell Copilot what to do differently (Esc to stop)

# 検証した結果を踏まえて、SKILL.md の中身(より具体的な手順や制約事項など)を更新
# => 1. Yes を選択
Do you want to update /Users/user/demo_skill/skills/pyt
hon-library-sync/SKILL.md?
❯ 1. Yes
  2. Yes, and don't ask again for file operations when in this directory 
(~/work/git)
  3. No, and tell Copilot what to do differently (Esc to stop)

# 以下が出ればOK
 demo_skill/skills/python-library-sync/  に Skill の雛形を作成しました。

•  SKILL.md : ライブラリ名・互換性の確認から、依存ファイルと  plugins.zip  の更新・検証までの手順を定義
•  skill-config.json : 対象ファイルのパス、ZIP の入力元・生成コマンドを設定可能(未指定時は既存プロジェクトから調査)

設定 JSON の形式は検証済みです。ZIP の具体的な構成や生成方法はプロジェクトごとに異なるため、未指定なら既存の手順を調べるようにしています。

【4】作成したSkillを実行するには

方法1:VS Code の GitHub Copilot Chat から呼び出す

[1] VS Code でプロジェクトを開く

作成した Skill が含まれるリポジトリを VS Code で開く

[2] Copilot Chat を開く

サイドバーから GitHub Copilot Chat のパネルを開く

[3] Agent モード(または通常チャット)で指示を出す

# 入力欄に、以下のように自然言語で指示を出す
~~~~
requests ライブラリ(バージョン 2.31.0)を追加して、requirements.txt と constraints.txt を更新し、plugins.zip を再生成して下さい
~~~~
 => 後は勝手にいい感じで実行してくれる

方法2:ターミナル(Copilot CLI)から呼び出す

* copilot-plugin-skill を使って対話した
 Copilot CLI からそのまま実行することもできる

[1] ターミナルでプロジェクトのルートディレクトリに移動

cd demo_skill

[2] copilot コマンドで対話モードを起動

copilot

[3] チャット上で指示を出す

~~~
@python-library-sync を使って、新しいライブラリ requests を追加して。
~~~
or
~~~
python-library-sync のスキルに従って、
requirements.txt に pandas を追加し、plugins.zip を再生成して
~~~

# Tips: 直接スキル名をメンションする
指示の冒頭に @python-library-sync のようにスキル名(またはタグ)
を書いて指名すると、確実にそのスキル(手順書)を読み込ませて
実行させやすくなる

関連記事

GitHub Skills 〜 入門編 〜
https://dk521123.hatenablog.com/entry/2026/09/25/122553
GitHub Skills 〜 基本編 〜
https://dk521123.hatenablog.com/entry/2026/11/01/003003
GitHub Skills 〜 スキル作成補助 〜
https://dk521123.hatenablog.com/entry/2026/10/30/131957
Github ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2019/07/18/234652

【Github】GitHub Skills 〜 スキル作成補助 〜

◾️はじめに

https://dk521123.hatenablog.com/entry/2026/09/25/122553

の続き。

GitHub Skillsを作成するための
スキル作成補助ツール的なものを調べてみた

目次

【1】copilot-plugin-skill
【2】awesome-copilot (github/awesome-copilot)
【3】skill-creator(スキルクリエイター)
【4】mattpocock / skills
【5】Skill Seekers

【1】copilot-plugin-skill

GitHub Copilot CLIなどで、
プラグインやMCP(Model Context Protocol)ツールを
伴う拡張機能を開発するための開発キット的なスキル

https://github.com/htekdev/copilot-plugin-skill

【2】awesome-copilot (github/awesome-copilot)

GitHub公式のコミュニティ主導による
Copilot用のカスタム指示、プロンプト、カスタムチャットモードのコレクション

https://github.com/github/awesome-copilot
例
1. https://github.com/github/awesome-copilot/blob/main/skills/microsoft-skill-creator/SKILL.md
2. https://github.com/github/awesome-copilot/blob/main/skills/python-pypi-package-builder/SKILL.md

【3】skill-creator(スキルクリエイター)

* Anthropicが提供する
* スキルやエージェントの定義(メタデータやMarkdown構造)
 を効率的に作成するためのツールや仕組み

特徴

対話を通じたファイル生成(SKILL.mdなど)、
マルチエージェントによる並列テスト・評価(Eval)、
トリガー(発動条件)説明文の最適化を支援

【4】mattpocock / skills

有名開発者Matt Pocockによる、
主に Claude Code 向けの高度なスキル・エージェント集

https://github.com/mattpocock/skills

【5】Skill Seekers

WebドキュメントやGitHubリポジトリを自動で読み込んで、
AI用の巨大なナレッジベース(Skillや.cursorrules等)を生成するツール

何をするものか

ドキュメントサイト、GitHubリポジトリ、PDFなどを
スクレイピング・解析し、AIが参照しやすい SKILL.md や
構造化された知識ファイル(コンテキスト)に自動変換

主な用途

 「Reactの最新ドキュメント全体」や「社内Wiki」を
AIに丸ごと学習・参照させて、
そのライブラリに超詳しいAIアシスタントを作るようなケース

関連記事

GitHub Skills 〜 入門編 〜
https://dk521123.hatenablog.com/entry/2026/09/25/122553
GitHub Skills 〜 基本編 〜
https://dk521123.hatenablog.com/entry/2026/11/01/003003
GitHub Skills 〜 copilot-plugin-skill 〜
https://dk521123.hatenablog.com/entry/2026/10/31/000303
Github ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2019/07/18/234652