Cursor Skills Setup for Projects and Users

A missing skill may be a scope problem, not a failed install. Cursor distinguishes repository skills, local personal skills and synced personal skills, with different behavior in Cloud Agents and automations.

Choose a Cursor skill scope

vibeforthat editorialUpdated 2026-11-042 sources

On this page

FIELD NOTESHow it fits together

Cursor

Codex

Trace a Cursor skill from folder to execution

01Identify the folder scopeDistinguish project skills from personal files on the local machine.

02Identify the execution surfaceCheck local, Cloud Agent and automation availability separately.

03Check required toolsA loaded instruction can still depend on scripts or external access.

01Project skills can live in .agents/skills or .cursor/skills.

02Synced personal skills do not load in automation runs.

03Portable files can still depend on client-specific tools or scripts.

Start with one practical task

Choose whether collaborators or just your own workspace need the skill. Test discovery with one task and check the active environment before relying on paths, files or local dependencies.

Choose between reusable skills and MCP

Choose repository or personal scope

Current docs support .agents/skills and .cursor/skills in projects, and corresponding personal directories. Compatibility paths also exist, but a host recognizing a file does not ensure its external tools or scripts work.

Compare Codex skill discovery

Account for Cloud Agents

Personal ~/.cursor/skills can be synced for Cloud Agents. The docs distinguish that sync from repository skills and say automations do not load synced personal skills. Put a shared automation workflow in the repository.

Troubleshoot the smallest missing piece

Inspect the loaded skill list, metadata, expected files and required programs. Try one bounded task and inspect its result before expanding to a broad collection. If the task runs remotely, confirm that the skill and its dependencies exist in that environment.

Separate missing instructions from missing access

A few more details

Can I reuse a skill from another agent?

The open format is portable, but paths, tools, scripts and invocation behavior still need host-specific review.

Will a personal local skill automatically run in every remote environment?

No. Cursor documents separate sync and worker rules; repository skills are usually the clearer shared artifact.

Sources & maker notes

This guide is based on the cited documentation and maker sources. vibeforthat has not run an independent installation or end-to-end product test for this article.