github / github/copilot-cli

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

未关闭
#4,401 0 条评论 1 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

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:

    ---
    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:

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.

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 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

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。