Menu
Use when: choosing the right Cursor search strategy for a workspace query, executing and refining searches, and acting on results — exact text, regex, semantic, and file-path discovery.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when running workspace tests, choosing a test command, or summarizing results before handoff to debugger.
Use when running workspace tests, choosing a test command, or summarizing results before handoff to debugger.
Use when: running pre-commit or pre-push CI-equivalent checks in any workspace — discovers workflow commands with Cursor tools, filters for local executability, scopes to staged changes, and runs checks cheapest-first.
Use when the user wants to install or customize cursorAssistant in the current project (GitHub install or configure).
Use when: running pre-commit or pre-push CI-equivalent checks in any workspace — discovers workflow commands with Cursor tools, filters for local executability, scopes to staged changes, and runs checks cheapest-first.
Use when: discovering package manifests, assessing dependency health, finding replacements, or confirming import usage before removal — discovery only; mutating installs are handled by the deps agent.
| name | workspaceSearch |
| description | Use when: choosing the right Cursor search strategy for a workspace query, executing and refining searches, and acting on results — exact text, regex, semantic, and file-path discovery. |
| version | 1.1 |
| license | MIT |
Procedural skill for selecting, executing, and acting on workspace searches in Cursor. Different intents need different tools; this skill routes first, refines on poor results, then dispatches findings.
| Intent | Best method |
|---|---|
| Exact string, identifier, or known phrase | Grep (fixed string) |
| Regex or alternation | Grep (regex) |
| Concept, purpose, natural-language | SemanticSearch |
| Files by name or path pattern | Glob |
| Read a known path | Read |
Scope before searching: pass a directory or glob to Grep/Glob when the target area is known.
Batch: issue independent searches in parallel when both exact and semantic views help.
| Symptom | Refinement |
|---|---|
| Zero results (exact) | Shorter substring; regex alternation |
| Zero results (semantic) | More concrete query; fall back to Grep for a key term |
| Zero results (glob) | Broaden pattern (e.g. **/*.py) |
| Too many hits | Narrow directory/glob; tighten pattern |
| Vendor/generated noise | Exclude node_modules, dist, .venv, __pycache__ from conclusions |
Do not repeat the same query twice. One refinement, then report failure with attempted queries.
| Goal | Action |
|---|---|
| Summarize scope | Count + representative paths; do not dump every match |
| Refactor scope | File list for the implementation step |
| Documentation | Quote 2–3 representative matches with paths |
| Unused symbol check | Zero imports across Grep patterns before claiming unused |
Use workspace-relative paths in summaries.
