CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cursor-codebase-indexing

Set up and optimize Cursor codebase indexing for semantic code search and @Codebase queries. Triggers on "cursor index", "codebase indexing", "index codebase", "cursor semantic search", "@codebase", "cursor embeddings".

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured single-file skill whose commands, config examples, and troubleshooting table are immediately executable. Its main costs are the 'How Indexing Works' section teaching concepts Claude already knows and the absence of explicit verification loops (and reference files) for the long tail of content.

Suggestions

Cut or compress the 'How Indexing Works' diagram and the nearest-neighbor explanation; keep only Cursor-specific behavior notes, since embedding and vector-search fundamentals are knowledge Claude already has.

Add explicit validation checkpoints to the Re-Indexing workflow, e.g. 'After resync, run a known @Codebase query and confirm results reference the refactored code; if stale, resync again before proceeding.'

Move the Linux inotify/sysctl walkthrough and the extended ignore-file example lists into a references/ file (e.g. references/optimization.md) linked one level deep from the Optimization section to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly dense, Cursor-specific guidance, but the 'How Indexing Works' diagram and the '@Codebase performs a nearest-neighbor search using your question's embedding' paragraph re-explain embedding/vector-similarity concepts Claude already knows. This matches 'mostly efficient but includes some unnecessary explanation' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is copy-paste ready throughout: complete .cursorignore/.cursorindexingignore examples, `cursor /path/to/monorepo/packages/api` commands, `cat /proc/sys/fs/inotify/max_user_watches` and sysctl commands, exact settings paths, and a symptom-cause-fix troubleshooting table. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Sequences are clear (Initial Setup, Re-Indexing with escalation, watcher-limit fix) with some checkpoints ('Wait for status bar to show indexing progress', 'Check status: look at the bottom status bar'). It is not a 5 because validation is implicit in places — e.g., no explicit 'verify @Codebase returns fresh results after resync' loop — fitting 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

With no bundle files, the single ~215-line SKILL.md is organized into well-labeled sections (Setup, Configuration, Optimization, Enterprise, Troubleshooting, Resources) that are easy to navigate. It is not a 5 because secondary material such as the inotify sysctl walkthrough and long ignore-file examples is inlined where one-level-deep reference files would keep the overview leaner.

4 / 5

Total

16

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit what-and-when structure and tool-specific trigger terms that make it highly discoverable and distinctive. The only weakness is that the capability list is limited to two verbs ('set up and optimize'), leaving the scope of 'optimization' (ignore files, monorepo strategy, troubleshooting) implicit.

DimensionReasoningScore

Specificity

The description names the domain ('Cursor codebase indexing') and two concrete actions ('Set up and optimize') plus purposes ('semantic code search and @Codebase queries'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because the remaining phrases are goals rather than additional distinct actions.

3 / 5

Completeness

It explicitly answers 'what' ('Set up and optimize Cursor codebase indexing for semantic code search and @Codebase queries') and 'when' via an explicit trigger clause ('Triggers on ...') with concrete phrases, matching the top anchor. A 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger list ('cursor index', 'codebase indexing', 'index codebase', 'cursor semantic search', '@codebase', 'cursor embeddings') covers natural user phrasings including verb and noun forms. It falls short of 5 because common variations users might say, such as 'cursor search', 'semantic search in cursor', or '.cursorignore' terms, are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Cursor's codebase indexing / @Codebase semantic search) with tool-specific triggers, so it is easily distinguishable from generic search or indexing skills. Conflict risk with other skills is minimal.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

BigSimmo/PsychSift

Path

.cursor/skills/cursor-codebase-indexing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.