Cursor Integration Guide
Step-by-step guide to use Agent Skills with Cursor AI.
Cursor AI Integration
Cursor is one of the most popular AI-powered code editors. It fully supports the Agent Skills standard, allowing you to extend its capabilities instantly.
Prerequisites
- Cursor AI installed on your machine
- A terminal with Node.js 18+ and npm/pnpm
Installation Methods
Method 1: Using the CLI (Recommended)
The easiest way to add skills to Cursor is via the npx command:
npx agent-skills install vercel-labs/agent-skills/web-design-guidelinesThis command will:
- Download the skill from GitHub
- Extract the SKILL.md manifest
- Configure Cursor to use the skill
Method 2: Manual Configuration
If you prefer manual setup:
-
Copy the Manifest URL:
https://raw.githubusercontent.com/vercel-labs/agent-skills/main/skills/web-design-guidelines/SKILL.md -
Open Cursor Settings:
- Press
Cmd + ,(Mac) orCtrl + ,(Windows/Linux) - Navigate to Features → Agent
- Press
-
Add Custom Skill:
- Paste the manifest URL in the "Custom Skills" section
- Click "Add Skill"
-
Restart Cursor to apply changes.
Using Skills in Chat
Once installed, you can invoke the skill by mentioning it in the chat:
@skill-name Help me design a responsive landing pageCursor will automatically load the skill context and provide tailored assistance.
Popular Skills for Cursor
| Skill | Description | Install Command |
|---|---|---|
| React Best Practices | Vercel's React conventions | npx agent-skills install vercel-labs/agent-skills/vercel-react-best-practices |
| Web Design Guidelines | Modern UI/UX principles | npx agent-skills install vercel-labs/agent-skills/web-design-guidelines |
| Frontend Design | Anthropic's design patterns | npx agent-skills install anthropics/skills/frontend-design |
Troubleshooting
Skill Not Working?
- Check Cursor Version: Ensure you're running Cursor 0.35+ which has full skill support.
- Verify Installation: Run
npx agent-skills listto see installed skills. - Clear Cache: Try
npx agent-skills clear-cacheand reinstall.
Permission Issues
If you encounter permission errors:
# Use sudo if needed (not recommended)
sudo npx agent-skills install <skill-name>
# Or fix npm permissions
npm config set prefix ~/.npm-global