Cursor Agent-Skills Setup

This project contains automation scripts to download the recommended agent skills from the addyosmani/agent-skills repository and place them in the target directory for Cursor (defaulting to .cursor/rules).

How it Works & Included Skills

The scripts provide an interactive selection menu in the terminal, allowing you to individually activate or deactivate any of the 24 skills from the repository.

• Auto-Detection: The scripts scan the target directory for existing skill files and automatically mark them as active in the menu.
• Default Skills: If no skills are currently present in the target directory, the following three best-practice skills are pre-selected by default:
  1. Test-Driven Development (test-driven-development.md)
  2. Code Review and Quality (code-review-and-quality.md)
  3. Incremental Implementation (incremental-implementation.md)
• Interactive Controls:
  • Type a number (1-24) to toggle the corresponding skill.
  • Type a to select all skills.
  • Type n to deactivate all skills (clear selection).
  • Type d (or simply press Enter) to apply the changes and start the download/sync process.
  • Type q to quit/cancel without making any changes.

Once confirmed, all activated skills are downloaded or updated, and any skills that were not (or are no longer) selected are automatically deleted from the target directory.

By placing these files in the .cursor/rules folder of your project, Cursor's AI agent will automatically load them into its context.

---

Usage

The scripts provide an interactive selection menu directly in your shell, automatically create the target directory (if it does not exist), and download the latest versions of the chosen skills directly from the GitHub repository.

Option 1: PowerShell (Windows)

1. Open PowerShell in the root directory of your target project.
2. Run the script:

   # Default: Downloads skills to the '.cursor/rules' folder in the current directory
   & "C:\Users\mbusc\source\repos\cursor-skills-setup\setup-skills.ps1"
   
   # Alternative: Specifying a custom target directory
   & "C:\Users\mbusc\source\repos\cursor-skills-setup\setup-skills.ps1" -TargetDir "C:\your\project\.cursor\rules"
   

Option 2: Bash (Linux / macOS / Git Bash)

1. Open the terminal in the root directory of your target project.
2. Run the script:

   # Default: Downloads skills to the '.cursor/rules' folder in the current directory
   bash /c/Users/mbusc/source/repos/cursor-skills-setup/setup-skills.sh
   
   # Alternative: Specifying a custom target directory
   bash /c/Users/mbusc/source/repos/cursor-skills-setup/setup-skills.sh ./my-custom-folder
   

---

Prerequisites

• Bash Script: Requires curl or wget.
• PowerShell Script: Requires at least PowerShell 3.0.