Skip to content

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

Closed as duplicate

Description

@Omzig

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.

Activity

  1. added
    area:platform-windowsWindows-specific: PowerShell, cmd, Git Bash, WSL, Windows Terminal
    area:toolsBuilt-in tools: file editing, shell, search, LSP, git, and tool call behavior
    and removed on Aug 8, 2026
  2. MarkBennett commented on Oct 15, 2026

    @MarkBennett

    Seeing the same in the Copilot cloud agent. Skills installed to ~/.agents/skills in copilot-setup-steps.yml appear in the agent's skill catalog, but the skill tool returns Skill "open-pr" not found. Available skills: customize-cloud-agent, merge-branch, github-pr-media. Copying a skill to ~/.copilot/skills failed 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:

    - name: Expose skills to Copilot's skill tool
      run: |
        mkdir -p .github/skills
        cp -r ~/.agents/skills/. .github/skills/
        echo .github/skills/ >> .git/info/exclude

    The skill then loads, and git status stays clean, so the agent doesn't commit the copies.

  3. tbenbrahim2 commented on Oct 25, 2026

    @tbenbrahim2

    still a problem in the latest version

    Image

    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.

    Image
  4. patniko commented on Oct 26, 2026

    @patniko
    Collaborator

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:platform-windowsWindows-specific: PowerShell, cmd, Git Bash, WSL, Windows Terminalarea:toolsBuilt-in tools: file editing, shell, search, LSP, git, and tool call behavior

    Type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions