Repository navigation
Regression: skill tool cannot find valid skills in ~/.agents/skills #4401
Description
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.
Activity
MarkBennett commentedon Oct 15, 2026
Seeing the same in the Copilot cloud agent. Skills installed to
~/.agents/skillsincopilot-setup-steps.ymlappear in the agent's skill catalog, but theskilltool returnsSkill "open-pr" not found. Available skills: customize-cloud-agent, merge-branch, github-pr-media. Copying a skill to~/.copilot/skillsfailed the same way.A workaround, not a fix: a project location does load. After installing, a setup step copies the skills into the checkout and keeps them out of git:
The skill then loads, and
git statusstays clean, so the agent doesn't commit the copies.tbenbrahim2 commentedon Oct 25, 2026
still a problem in the latest version
It does eventually find the skill and read it. It is just disconcerting seeing the same error for months. Thiis happens for local skills also, as in this case.
patniko commentedon Oct 26, 2026
Thanks for the report! This is the same issue as #4438, so I'm closing this one as a duplicate. Please follow that issue for updates and add any extra details there.
Triaged as part of a Copilot SDK backlog review, with help from GitHub Copilot.