Personal skills in ~/.copilot/skills/ are never discovered, despite being documented as a source
まだ誰も着手していません。
- 主要言語
- Shell
- スター
- 11.2k
- フォーク
- 1.9k
- 平均マージ
- 14時間 16分
- マージ済み PR(30日)
- 6
説明
Describe the bug
Summary
copilot skill --help documents ~/.copilot/skills/ as a "Personal" skill
source, but skills placed there are never discovered. copilot skill list
returns only builtin skills. Project and custom sources work correctly in the
same version, so this appears specific to the personal source.
Affected version
| Copilot CLI | 1.0.81-5 |
Steps to reproduce the behavior
Reproduction
- Create a minimal personal skill:
mkdir ~/.copilot/skills/zz-repro-demo
~/.copilot/skills/zz-repro-demo/SKILL.md:
---
name: zz-repro-demo
description: "Minimal skill used to reproduce personal skill discovery."
---
# Repro demo
Say hello.
- From a directory containing no project skills, run:
copilot skill list --json
Result:
[
{ "name": "customize-cloud-agent", "source": "builtin" },
{ "name": "github-pr-media", "source": "builtin" }
]
The personal skill is absent. Plain copilot skill list prints only a
Builtin skills: section, with no Personal skills: heading.
Expected behavior
Expected behavior
Per copilot skill --help:
Skills are discovered from several sources:
Project .github/skills/, .agents/skills/, or .claude/skills/
Personal ~/.copilot/skills/ or ~/.agents/skills/
Plugin Installed plugins that bundle skills
Custom Directories added with `copilot skill add <directory>`
A valid skill in ~/.copilot/skills/<name>/SKILL.md should appear in
copilot skill list with source personal.
Actual behavior
It does not appear at all.
Additional context
What this is not
- Not invalid frontmatter. The repro skill above is newly created and
minimal. Four other valid personal skills on this machine are equally absent. - Not a symlink/junction resolution issue. The repro directory is a real
directory. A separate real-directory skill is also invisible, alongside
junctioned ones. All are equally absent. - Not general discovery breakage. From a repo containing
.github/skills/, those skills list correctly with sourceproject. - Not a missing scope flag.
copilot skill list --helpoffers only
--json; there is no flag to include other sources. - Not user configuration. Nothing in
~/.copilot/settings.jsonor
config.jsonreferences skills or disables a source.
The custom source works, which narrows it
Registering the same directory explicitly does work:
copilot skill add /path/to/zz-repro-demo
copilot skill list --json
[
{ "name": "zz-repro-demo", "source": "custom" },
{ "name": "customize-cloud-agent", "source": "builtin" },
{ "name": "github-pr-media", "source": "builtin" }
]
Identical skill content, discovered under custom but not under personal.
This suggests the loader itself is fine and the personal source is either not
enumerated or is filtered out.
Impact
The documented way to install a skill for use across all projects does not
work. The only working alternatives are to place skills inside each project's
.github/skills/, or register each directory individually with
copilot skill add. For anyone maintaining reusable skills across several
repositories, this forces per-project copies, which then drift.
Environment
| Copilot CLI | 1.0.81-5 |
| Install method | WinGet (GitHub.Copilot) |
| OS | Windows 11 Enterprise, 10.0.26200.0 |
| Architecture | ARM64 |
| Shell | PowerShell 7.6.5 (Core) |
Possibly related, lower priority
copilot skill remove <name> fails for a skill registered via
copilot skill add <directory>, even though copilot skill list displays it
by name and the help text says remove <name-or-directory>:
Error: No custom, personal, or project skill found matching "zz-repro-demo".
Happy to split this into its own issue if preferred.
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず ~/.copilot/skills/zz-repro-demo/SKILL.md を使って問題を再現し、次に copilot skill add で登録した同じディレクトリと copilot skill list --json を比較します。copilot skill --help に記載されている動作を確認してください。有効な個人用 skill が、カスタム登録なしでソース personal とともに一覧に表示されれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- powershell, shell
- 領域
- cli
- issue の種類
- バグ
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 活発さ
- 活発
- 明瞭さ
- 明確に書かれている
- 初心者へのやさしさ
- 68/100