# Graph Search

> Searches the code knowledge graph by function, class, or type using FTS5 full-text search. Use when locating code entities by name or qualified path.

- Skill: `majiayu000/graph-search-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/graph-search-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/graph-search-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/majiayu000/graph-search-2

---


# Search Code Knowledge Graph

Search `.gauntlet/graph.db` for code entities by name.

## Steps

1. **Accept query**: Get the search term from the user.

2. **Run the query script**:
   ```bash
   python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_query.py \
       --action search --query "<term>" --limit 20
   ```

   Optional filters:
   - `--kind Function` to search only functions
   - `--kind Class` to search only classes

3. **Display results**: Show qualified name, file path,
   line numbers, and relevance score for each match.

4. **Offer to read**: Ask if the user wants to read the
   top result's source file.

## Query Intelligence

The search engine detects query patterns:

- **PascalCase** (e.g., `UserService`): boosts Class
  and Type results
- **snake_case** (e.g., `get_users`): boosts Function
  results
- **Dotted path** (e.g., `app.models.User`): boosts
  qualified name matches

## Prerequisites

The graph must be built first. If `.gauntlet/graph.db`
does not exist, suggest running the `graph-build` skill.