component-search

name	component-search
description	Search across cursor-handbook rules, agents, commands, and skills for a specific term or topic. Use when the user asks to find a component, search for a keyword, or locate where something is defined.

Skill: Component Search

Search across all cursor-handbook component types (rules, agents, commands, skills) to find files matching a term or topic.

Trigger

When the user asks to find a rule, agent, skill, or command by keyword — or wants to know where a specific topic is covered in the handbook.

Prerequisites

• cursor-handbook .cursor/ directory exists
• grep command available (standard on macOS/Linux)

Usage

Run the bundled script:

scripts/search-components.sh <search-term>

Examples

Find all components related to "security":

scripts/search-components.sh security

Find components mentioning "database":

scripts/search-components.sh database

Find components referencing "correlationId":

scripts/search-components.sh correlationId

Steps

Step 1: Identify Search Term

• Determine what the user is looking for
• If vague, suggest specific terms or ask for clarification

Step 2: Run Search

• Execute using the Shell tool