Regression: skill tool cannot find valid skills in ~/.agents/skills
还没有人认领这个 Issue。
- 主要语言
- 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
-
Create or install a skill at
~/.agents/skills/setup-matt-pocock-skills/SKILL.md. -
Ensure its frontmatter includes:
--- name: setup-matt-pocock-skills description: Configure this repo for the engineering skills. disable-model-invocation: true --- -
Invoke the skill tool with
setup-matt-pocock-skills.
Actual result
The tool returns:
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:
---
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:
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:
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.
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
首先跟踪 CLI 的 skill 发现机制和可用 skill 注册表,并比较 Windows 上受支持的 ~/.copilot/skills 路径与 ~/.agents/skills。使用报告中描述的最小 test-skill 复现问题,然后验证 ~/.agents/skills 下的 skills 是否会被发现并调用,或者 CLI 是否会明确报告该目录不受支持。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- shell
- 领域
- cli
- Issue 类型
- 缺陷
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 冷清
- 描述清晰度
- 基本清楚
- 新手友好度
- 55/100