Cursor Setup

Experimental
โš ๏ธ
Experimental support. Cursor does not have a native plugin marketplace, so skills are installed manually via a script. Updates require re-running the install. For the best experience with automatic updates and full skill support, use Claude Code โ€” the primary supported platform.

Cursor 2.4+ supports the Agent Skills open standard but does not support Claude Code plugin marketplace. This installation uses a direct install script as a workaround. All Showroom skill content (templates, prompts, docs) is the same as the Claude Code version.

Works With

  • Cursor 2.4.0 or later
  • Agent Skills support

What You Get

  • One-command installation
  • All 8 skills bundled
  • Same templates & docs as Claude Code

Prerequisites

โ„น๏ธ

Check Your Cursor Version

  1. Open Cursor
  2. Click Cursor menu โ†’ About Cursor
  3. Version should be 2.4.0 or higher

If you're on an older version, update Cursor first.


Installation

One-Command Install

โœ…
Run this in your TERMINAL (not in Cursor chat):
curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install-cursor.sh | bash
โ„น๏ธ

This script will automatically:

  • Install all 7 skills to ~/.cursor/skills/
  • Install documentation to ~/.cursor/docs/
  • Bundle prompts and templates with each skill
  • Everything configured in one step

Verify Installation

After the script completes:

ls ~/.cursor/skills/
โœ…
You should see these 7 skills:
  • showroom-create-lab
  • showroom-create-demo
  • showroom-blog-generate
  • showroom-verify-content
  • agnosticv-catalog-builder
  • agnosticv-validator
  • health-deployment-validator
โš ๏ธ
Important: Restart Cursor after installation to load the new skills.

How to Use Skills

Method 1: Explicit Invocation

Type skill names directly in Cursor Agent chat:

Showroom Skills

/showroom-create-lab
/showroom-create-demo
/showroom-blog-generate
/showroom-verify-content

AgnosticV Skills

/agnosticv-catalog-builder
/agnosticv-validator

Health Skills

/health-deployment-validator
โ„น๏ธ
Note: Cursor skill names use hyphens (not colons) due to platform naming restrictions.

Method 2: Natural Language

The agent will automatically apply relevant skills based on your request:

โ„น๏ธ

Example Prompts

  • "Help me create a workshop lab module"
  • "Generate demo content for my presentation"
  • "Create an AgnosticV catalog configuration"
  • "Verify my workshop content quality"

Verification

After installation and restart, verify skills are loaded:

  1. Open Cursor Agent chat (Cmd+L or Ctrl+L)
  2. Type / to see available skills
  3. You should see RHDP skills listed

Using Both Claude Code and Cursor?

โš ๏ธ

Duplicate Skills Warning

If you have both Claude Code and Cursor installed, you may see duplicate skills with different names:

Platform Skill Names Example
Claude Code (plugin) With colons /showroom:create-lab
Cursor (script) With hyphens /showroom-create-lab

Both skills are identical - they just have different names due to platform naming requirements.

โœ…

Recommendation

Choose one installation method:

  • Claude Code users: Use the plugin marketplace (automatic updates, full integration)
  • Cursor-only users: Use this install script
  • Both platforms: Use Claude Code plugin, skip this script for Cursor

Updating Skills

โœ…
Run this in your TERMINAL (not in Cursor chat):

To update to the latest version:

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/update-cursor.sh | bash
โ„น๏ธ

The update script will:

  • Check for new versions
  • Show changelog
  • Backup current installation
  • Install latest version
โš ๏ธ
Manual Updates Required: Unlike Claude Code plugin marketplace, Cursor updates are manual. Claude Code users get automatic update notifications.

Troubleshooting

Skills not showing after installation

Most common issue: Symlinks instead of actual files

Fix:

# Verify you have actual files (not symlinks)
file ~/.cursor/skills/showroom-create-lab/SKILL.md

# If it says "symbolic link", copy actual files:
cp -r ~/.agents/skills/* ~/.cursor/skills/

# Restart Cursor

Other checks:

  1. Restart Cursor completely (Cmd+Q / Ctrl+Q, then reopen)
  2. Verify installation: ls ~/.cursor/skills/
  3. Check Cursor version is 2.4.0+
Skills show but don't work properly

Missing support files (templates, prompts, docs):

# Copy .claude/ directory to your project
cd ~/your-project
git clone https://github.com/rhpds/rhdp-skills-marketplace.git /tmp/rhdp-marketplace
mkdir -p .claude
cp -r /tmp/rhdp-marketplace/showroom/.claude/* .claude/
rm -rf /tmp/rhdp-marketplace
Permission denied errors

Make sure you have write permissions:

ls -la ~/.cursor/
chmod 755 ~/.cursor/skills