Skills installed by skill.sh will not be found if use Symlink method

Support Bug Reports
1

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

Skills installed by skill.sh will not be found if use Symlink method.

Steps to Reproduce

  1. use npx skills add https://github.com/anthropics/skills --skill pdf to install pdf skill
  2. choose Installation method ● Symlink (Recommended) (Single source of truth, easy updates)
  3. After install successfully, reboot cursor

Expected Behavior

the pdf skill should be found and active.

Operating System

MacOS

Version Information

Version: 2.4.28
VSCode Version: 1.105.1
Commit: f3f5cec40024283013878b50c4f9be4002e0b580
Date: 2026-02-03T00:56:18.293Z
Build Type: Stable
Release Track: Default
Electron: 39.2.7
Chromium: 142.0.7444.235
Node.js: 22.21.1
V8: 14.2.231.21-electron.0
OS: Darwin arm64 25.2.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

4

Hey, this is a known issue. Cursor doesn’t follow symlinks when it discovers skills yet. The team knows about it (a ticket is logged), and I’ll add your report to it.

Similar thread with details: Cursor doesn't follow symlinks to discover skills

Workaround (from @CristianDeluxe, works on macOS):

# 1. Grant recursive read permissions
chmod -R +r ~/.agents/skills

# 2. Remove all skills (make a backup if you need one)
npx skills remove --all -y -g

# 3. Reinstall skills again, and this time pick Copy instead of Symlink
npx --yes skills add https://github.com/anthropics/skills --skill pdf --global --yes

After reinstalling using the Copy method, it should work. Let me know if it doesn’t.

6

This is fixed now in 2.5!

7

Nice! Also in the CLI agent?

8

From what I can see, it is still broken in the CLI: I am on 2026.02.13-41ac335

9

@niek_cognite @salmanmashayekh Can you try again with 2026.02.27?

agent update should get you there!

10

Thanks for the ping @Colin . Just tested it and it is fixed! :slight_smile: