github / github/copilot-cli

Regression: skill tool cannot find valid skills in ~/.agents/skills

未關閉
#4,401 0 則留言 1 個 reaction 已指派 0 人 在 GitHub 檢視
area:platform-windows area:tools
主要語言
Shell
星號
11.2k
分支
1.9k
平均合併
14 小時 16 分鐘
30 天內合併 PR
6

描述

## Description

The `skill` tool cannot find or invoke a valid skill installed under `~/.agents/skills`, even though the skill directory and `SKILL.md` are present.

This appears to be a regression or an incomplete fix related to #2230, which is closed.

## Environment

- Copilot CLI: `1.0.78`
- OS: Windows
- Skill path: `C:\Users\omzig\.agents\skills\setup-matt-pocock-skills\SKILL.md`

## Reproduction

1. Create or install a skill at `~/.agents/skills/setup-matt-pocock-skills/SKILL.md`.
2. Ensure its frontmatter includes:

```yaml
---
name: setup-matt-pocock-skills
description: Configure this repo for the engineering skills.
disable-model-invocation: true
---
```

3. Invoke the skill tool with `setup-matt-pocock-skills`.

## Actual result

The tool returns:

```text
Skill not found: setup-matt-pocock-skills
```

The skill is also absent from the tool's available-skill registry, despite the file being present and having valid frontmatter.

## Expected result

Skills in `~/.agents/skills` should either be discovered by the CLI automatically or produce a clear configuration/status indication explaining that the directory is unsupported.

## Workaround

Copying or linking the skill into a directory that the CLI does discover appears to be required.

## Additional validation: minimal test skill

To rule out a problem specific to the original skill, I created a minimal skill with valid frontmatter at:

`C:\Users\omzig\.agents\skills\test-skill\SKILL.md`

Its contents were:

```markdown
---
name: test-skill
description: A simple test skill that confirms whether skills installed in ~/.agents/skills are discovered and invoked.
---

# Test Skill

When this skill is invoked, respond with exactly:

`test-skill loaded successfully`
```

Invoking `skill(test-skill)` produced the same result:

```text
Skill not found: test-skill
```

This validates that the failure is with out-of-box discovery of `~/.agents/skills`, not with the original skill's complexity or frontmatter.

## Follow-up validation: supported path works

I moved the same minimal `test-skill` directory from:

`C:\Users\omzig\.agents\skills\test-skill`

to:

`C:\Users\omzig\.copilot\skills\test-skill`

After moving it, invoking `skill(test-skill)` succeeded and the skill returned:

```text
test-skill loaded successfully
```

This confirms that the skill content and frontmatter are valid. The failure is specifically that `~/.agents/skills` is not included in the CLI's out-of-box discovery paths, while `~/.copilot/skills` is.

貢獻指南

開啟貢獻指南

研究方向

先追蹤 CLI 的 skill 探索機制與可用 skill 登錄表,比較 Windows 上受支援的 ~/.copilot/skills 路徑與 ~/.agents/skills。使用報告中描述的最小 test-skill 重現問題,接著確認 ~/.agents/skills 下的 skills 是否會被探索並呼叫,或 CLI 是否會清楚地回報該目錄不受支援。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
shell
領域
cli
Issue 類型
缺陷
難度
3/5
預估耗時
1-2 天
活躍度
冷清
描述清晰度
基本清楚
新手友好度
55/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。