# Code Search Ast Lookup

> Use the provided script to find definitions without wasting context. Use when this capability is needed.

- Skill: `tomevault-io/code-search-ast-lookup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/code-search-ast-lookup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/code-search-ast-lookup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/code-search-ast-lookup

---


# Skill: Smart Code Search

## When to use
- You see an import `from .models import UserProfile` and need to know where `UserProfile` is defined.
- You need to find a function logic but don't know the file name.
- **Goal**: Avoid opening random files with `view_file`.

## How to use
Run the `ast_lookup.py` script provided in the kit.

### Command
```bash
python3 scripts/ast_lookup.py <SymbolName> <RootPath>
```

### Example
**User Request**: "Update the calculate_total function."
**Agent Action**: "I don't know where that function is. I will search for it."

```bash
python3 scripts/ast_lookup.py calculate_total .
```

**Output**:
`./sales/utils.py:42 [FunctionDef]`

**Next Step**:
Now you can confidently run:
`view_file ./sales/utils.py` (focusing on line 42).

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/tgalioautomation) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->