Skip to content

[Bug]: Skill detection fails for symlinked skills in most supported agents #8256

Closed

Description

@xxww0098

Description

The Agent Coverage section does not correctly detect a skill installed through symbolic links.

I installed the same skill for all supported agents by creating symlinks in each agent's expected skills directory. The symlinks are valid, and the skill can be accessed from those locations.

However, Orca reports that only Claude and Codex are ready:

  • Claude: Ready
  • Codex: Ready
  • Claude Agent Teams: Missing
  • Grok: Missing
  • OpenCode: Missing
  • Pi: Missing
  • Antigravity: Missing
  • Cursor: Missing

The UI therefore shows “2 of 8 detected agents have the skill.”

Steps to reproduce

  1. Install a skill in a shared directory.
  2. Create symbolic links to that skill inside the skills directory used by each supported agent.
  3. Open Orca and view the Agent Coverage section.
  4. Observe that only Claude and Codex are detected as ready.

Expected behavior

Orca should follow valid symbolic links and detect the installed skill for every supported agent whose skills directory contains a valid symlink to it.

If symlink-based installation is intentionally unsupported, the UI or documentation should clearly explain that limitation.

Actual behavior

Symlinked skills are detected for Claude and Codex, but not for Claude Agent Teams, Grok, OpenCode, Pi, Antigravity, or Cursor.

This suggests that the detection logic is inconsistent between agent integrations, or that some integrations check for regular directories/files without resolving symbolic links.

Environment

  • OS: macOS
  • Installation method: The skill was installed once and symlinked into each agent’s skills directory

Additional information

A screenshot is available showing the Agent Coverage result, with only Claude and Codex marked as ready.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions