How to make local Cursor skills available for use in cloud agents chat

Support Help
,
1

For eg, I have the following:

Screenshot 2026-07-17 at 10.37.55 PM
Screenshot 2026-07-17 at 10.37.55 PM715×174 31.9 KB

Locally, I have setup global user level skills that I want to use across my personal Github repos. This works fine when running in the local chat on my macbook.

But when I want to use them for the cloud agents online, I found these are not accessible because they’re only locally available on my machine.

So what’s the official or unofficial way to publish the global user skills for the cloud agents to uses?

5

Hey, thanks for the request. From your screenshot, I can see your global skills in ~/.cursor/skills/. Those only apply to agents running on the same machine local chat. Cloud Agents start in a separate VM and don’t sync your laptop home directory, so global skills don’t show up there. That’s expected behavior today.

Working ways to make skills available to Cloud Agents:

  • Commit them to the repo easiest and works now. Put each skill in .cursor/skills/<name>/SKILL.md or .agents/skills/ and commit. Cloud Agents will pick them up automatically from the checkout. If you want a skill only for you but still in the repo, use .cursor/skills/personal/<your-email>/<name>/ with metadata.scopedTo in the frontmatter.
  • Install them on the cloud VM so you can use them across repos without committing them everywhere. In .cursor/environment.json, in the environment install script, copy or generate your skills into ~/.cursor/skills/ on the VM. Cloud Agents read the VM’s ~/.cursor/skills/, so this works.
  • Team Marketplace plugin Teams or Enterprise. Wrap the skills into a plugin and mark it as Required. Then it installs for everyone and Cloud Agents can use it.
  • Agents API. If you start agents programmatically, pass a skills array when creating the agent. The content will be written into ~/.cursor/skills/ on the VM during provisioning.

There’s no automatic sync of global ~/.cursor/skills/ from your laptop to the cloud VM yet. It’s on the radar as a request, but I can’t share an ETA.

Let me know if anything doesn’t work.

6

Thanks @deanrie for the explanation.

I suspected you don’t have official setup to sync our user level cursor skills onto the cloud when reading between the Cursor docs.

All good.

I’ll evaluate if I need to make duplicate my user cursor skills separately on individual repos. Will be one on a case by case basis.

Cheers.

7

Glad we cleared that up. One small note on your plan: to avoid manually duplicating skills in every repo, you can set up their install once in ~/.cursor/skills/ via an install script in .cursor/environment.json. Then Cloud Agents will pick them up on the VM across all repositories without needing to commit them into each one.

So copying them per repo isn’t the only option if you want a shared set of skills.

If you decide this still doesn’t fit your setup, let me know and we’ll figure it out.