Cursor Migration Guide

cursor-commands → install script

Migrating from old cursor-commands/cursor-rules to the new install script.

What Changed?

Old Way

Old Approach (Deprecated)

  • ✗ Manual file copying to ~/.cursor/skills/
  • ✗ Separate cursor-commands/ and cursor-rules/ directories
  • ✗ Manual updates required
  • ✗ No version management
New Way

New Approach (Recommended)

  • ✓ One-command installation
  • ✓ Bundled dependencies
  • ✓ Automatic installation script
  • ✓ Easy updates with update script

Migration Steps

  1. Remove Old Installation

    Clean up old cursor-commands and cursor-rules:

    # Remove old cursor-commands skills
rm -rf ~/.cursor/skills/create-lab
rm -rf ~/.cursor/skills/create-demo
rm -rf ~/.cursor/skills/agv-generator
rm -rf ~/.cursor/skills/verify-content
rm -rf ~/.cursor/skills/blog-generate

# Remove old cursor-rules
rm -rf ~/.cursor/rules/agnosticv-catalog-builder
rm -rf ~/.cursor/rules/agnosticv-validator
rm -rf ~/.cursor/rules/showroom-standards
rm -rf ~/.cursor/rules/deployment-health-checker

# Remove old docs
rm -rf ~/.cursor/docs/SKILL-COMMON-RULES.md
rm -rf ~/.cursor/docs/AGV-COMMON-RULES.md

  2. Install via Install Script

    Run the one-command install script:

    curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install-cursor.sh | bash
    ℹ️
    This installs all 7 skills to ~/.cursor/skills/ with bundled dependencies

  3. Restart Cursor

    Completely quit and reopen Cursor to load the new skills.

  4. Verify Installation

    Check that 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
    ✅
    You should see:
    • /showroom-create-lab
    • /showroom-create-demo
    • /showroom-blog-generate
    • /showroom-verify-content
    • /agnosticv-catalog-builder
    • /agnosticv-validator
    • /health-deployment-validator

Skill Name Changes

ℹ️
Skills now use hyphens instead of colons (Cursor naming requirement):
Old Name (cursor-commands) New Name (install script)
/create-lab /showroom-create-lab
/create-demo /showroom-create-demo
/agv-generator /agnosticv-catalog-builder
/verify-content /showroom-verify-content
/blog-generate /showroom-blog-generate
/agnosticv-validator /agnosticv-validator
/deployment-health-checker /health-deployment-validator
ℹ️
Note: Hyphens (not colons) are used due to Cursor platform naming restrictions.

Configuration Files

✅

No Changes Required

Your existing configuration files (e.g., ~/CLAUDE.md) work without changes:

# AgnosticV Configuration
agnosticv: ~/devel/git/agnosticv
base_path: ~/work/code

Skills will automatically detect these paths.

Benefits of Migration

📦

One-Command Install

Single script installs everything

🔄

Easy Updates

Run update script to get latest versions

📚

Bundled Dependencies

All prompts and templates included

✓

Better Reliability

Actual files (not symlinks)

Troubleshooting

Skills not showing after installation
  1. Restart Cursor completely (quit and reopen, not just reload)
  2. Check installation: ls ~/.cursor/skills/
  3. Verify Cursor version is 2.4.0+
Old skills still showing

Remove old installations:

# List all skills in ~/.cursor/skills/
ls -la ~/.cursor/skills/

# Remove specific old skills
rm -rf ~/.cursor/skills/old-skill-name

Restart Cursor.

Permission denied errors

Make sure you have write permissions:

ls -la ~/.cursor/
mkdir -p ~/.cursor/skills  # Create if doesn't exist
chmod 755 ~/.cursor/skills
Skill names don't work with hyphens

Old cursor-commands used slashes. The new format uses hyphens:

/showroom-create-lab         (not /create-lab)
/agnosticv-catalog-builder   (not /agv-generator)

This is a Cursor platform naming requirement.

Updating Skills

ℹ️

Run the Update Script

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/update-cursor.sh | bash

The script will:

  • Check for new versions
  • Show changelog
  • Backup current installation
  • Install latest version

Rollback (If Needed)

Click to see rollback instructions

If you need to rollback to old approach:

# Remove current installation
rm -rf ~/.cursor/skills/showroom-*
rm -rf ~/.cursor/skills/agnosticv-*
rm -rf ~/.cursor/skills/health-*

# Note: Old cursor-commands/cursor-rules are deprecated
# Contact #forum-demo-developers for help if needed
⚠️
Warning: Old cursor-commands/cursor-rules are deprecated and no longer maintained.

Cursor Setup Guide

Full setup guide for Cursor

Quick Reference

Commands at a glance

Troubleshooting

Common issues and solutions
ℹ️

Migration Timeline

  • v2.3.x and earlier: cursor-commands/cursor-rules approach
  • v2.4.0+: Install script approach (current)
  • Future: Old approach will be completely removed

Migrate now to stay up-to-date!