code-search
/code-search
Compares semantic, text, and structural search strategies. Use for intent-based discovery with sgrep or selecting a search/codemod approach, not for ordinary known-string lookups.
- Author
- edmundmiller ↗
- Repository
- dotfiles ↗
- Licence
- MIT
- Last repository change
- 25.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Compares semantic, text, and structural search strategies. Use for intent-based discovery with sgrep or selecting a search/codemod approach, not for ordinary known-string lookups.
Original author description
Compares semantic, text, and structural search strategies. Use for intent-based discovery with sgrep or selecting a search/codemod approach, not for ordinary known-string lookups.
How it works
- Semantic discovery with sgrep
- ast-grep vs ripgrep
- Rule of Thumb
- ripgrep examples
- Mental Model
- Quick Decision Tree
- Selection examples
SKILL.md preview
---
name: code-search
description: Compares semantic, text, and structural search strategies. Use for intent-based discovery with sgrep or selecting a search/codemod approach, not for ordinary known-string lookups.
---
# Code Search Tool Selection
Use this skill to choose the search or refactoring tool. After selecting ast-grep, load `ast-grep`; that skill owns pattern syntax, rewrites, repository rule setup, tests, severity, and CI.
## Semantic discovery with sgrep
Use Context.dev's `sgrep` when you know the behavior but not its identifiers.
Scope the search to a likely directory and inspect the returned source before
drawing conclusions. Rankings are approximate, not proof of behavior.
```bash
sgrep "retry failed requests with backoff" ./src -n 5 --json
```
When you already have useful patterns, rank only their matching passages. Run
both commands from the same directory so ripgrep paths resolve correctly.
```bash
rg --json -C 3 'retry|backoff' ./src \
| sgrep "retry failed requests with backoff" --stdin --json
```
Keep `rg` for exact names, literals, and regexes. Keep `ast-grep` for syntax and
rewrites. If `sgrep` is unavailable, use scoped `rg` searches instead.
The first search downloads a 32–34 MB model and any required parsers. Source and
queries stay local, but the local index caches source passages. After assets
are cached, set `HF_HUB_OFFLINE=1` to prevent further downloads. `--no-cache`
disables index reads and writes, not model downloads. Do not bypass ignore
rules to include secrets in a search.
Upstream: https://github.com/context-dot-dev/sgrep. Other projects also use the
name `sgrep`; use the version packaged by these dotfiles.
## ast-grep vs ripgrep
### When to Use ast-grep
**Use `ast-grep` when structure matters.** It parses code and matches AST nodes, so results ignore comments/strings, understand syntax, and scope rewrites to matched code.
**Best for:**
- Refactors/codemods: rename APIs, change import forms, rewrite call sites or variable kinds
- Policy checks: enforce patterns across a repo (`scan` with rules + `test`)
- Editor diagnostics and automation: LSP mode; structured JSON output
- Syntax-structured code changes after previewing the matches
### When to Use ripgrep
**Use `ripgrep` when text is enough.** It's the fastest way to grep literals/regex across files.
**Best for:**
- Recon: find strings, TODOs, log lines, config values, or non‑code assets
- Pre-filter: narrow candidate files before a precise pass
- Quick searches where you just need to **find text**
## Rule of Thumb
- Know the behavior but not the identifiers → start with `sgrep`
- Need a syntax-structured code change → start with `ast-grep`
- Need raw speed or you're just **hunting text** → start with `rg`
- Often combine: `rg` to shortlist files, then `ast-grep` to match/modify with precision
## ripgrep examples
**Quick textual hunt:**
```bash
rg -n 'console\.log\(' -t js
```
**Find in specific file types:**
```bash
rg 'TODO|FIXME' -t py -t js
```
**Context around matches:**
```bash
rg -C 3 'error' -t log
```
**List files with matches:**
```bash
rg -l 'import.*React' -t tsx
```
## Mental Model
| Aspect | ast-grep | ripgrep |
| ------------------- | -------------------------- | ----------------------- |
| **Unit of match** | AST node | Line |
| **False positives** | Low (understands syntax) | Depends on regex |
| **Rewrites** | Syntax-scoped | Text replacement, risky |
| **Speed** | Slower (parses code) | Fastest (text only) |
| **Use case** | Structural search/refactor | Text search/grep |
## Quick Decision Tree
```
Need to change syntax-structured code?
├─ Yes → ast-grep
└─ No
├─ Searching code structure? → ast-grep
├─ Searching by behavior without known names? → sgrep
└─ Just finding text? → ripgrep
```
## Selection examples
- Find function definitions by syntax → use ast-grep, then load `ast-grep`.
- Refactor API calls → use ast-grep; do not use text replacement.
- Find TODOs, log messages, or configuration values → use ripgrep.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · edmundmiller/dotfiles | 100 | MIT |
| langwatch/langwatch | 100 | Apache-2.0 |
| atretyak1985/swarmery | 100 | Apache-2.0 |
| athola/claude-night-market | 100 | MIT |
| elastic/sourcerer | 100 | Apache-2.0 |
| brettatoms/agent-skills | 100 | MIT |
| agentscope-ai/agentscope-java | 90 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version b3d65a3e63dd (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100sgrep
Semantic and hybrid code and conversation search for intent-based queries. Use when exploring unfamiliar codebases, finding code by concept instead of exact text, or recalling past agent conversations about similar problems. - 90find-similar-code
Find code similar to a given snippet or description using semantic vector search. Use to discover existing implementations, patterns, reference code, or potential duplication. - 100csp-search
Search any codebase by intent or symbol with csp instead of grep. Use for finding code by what it does, locating implementations, understanding how something works, or discovering related code. - 100cursor-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". - 100ast-grep
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should… - 100ast-grep
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should…