investigate

Search code with ripgrep and analyze results with Gemini to resolve software bugs.

24|6|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/johnlindquist/claude --skill investigate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/johnlindquist/claude/tree/main/skills/investigate
Command: npx skills add https://github.com/johnlindquist/claude --skill investigate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers debug and investigate code issues efficiently by combining fast local search with AI-powered analysis. It reduces time spent chasing bugs and tracing execution flow.

Core Features & Use Cases

  • Systematic search with ripgrep to locate relevant code quickly.
  • AI-assisted analysis using Gemini to interpret findings and suggest fixes.
  • Trace execution: identify where errors originate and how data flows through your code.
  • Use Case: You are stuck on a null reference error in a TypeScript project; this Skill quickly locates relevant calls, traces the call stack, and provides a suggested root cause.

Quick Start

Start by installing prerequisites: ripgrep and google-generativeai, then configure GEMINI_API_KEY. Run a sample search like: rg "error" src/ --glob "!node_modules"

Frequently Asked Questions about investigate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a null reference error by tracing code execution?

Debugging with AI-guided code analysis combines fast ripgrep searches to locate relevant calls with Gemini AI analysis to trace execution flow and identify root causes, reducing time spent manually following stack traces.

Can I use ripgrep and AI analysis to find where a function is called in my TypeScript project?

Yes. Ripgrep performs targeted searches across your codebase to locate function definitions and usages, while Gemini AI interprets the results to map call chains and dependencies, helping you understand data flow quickly.

What's the best way to investigate code issues across multiple files without manual searching?

Systematic search with ripgrep finds relevant code instantly by excluding unnecessary directories, then AI-assisted analysis synthesizes findings to suggest fixes and explain complex code paths across TypeScript, Python, and other projects.

Do I need to set up ripgrep and an API key before I can start debugging?

Yes. Prerequisites include installing ripgrep for fast local search, the google-generativeai library, and configuring GEMINI_API_KEY to enable AI-powered analysis of search results.

How does AI-assisted code analysis improve over manual debugging workflows?

AI analysis interprets ripgrep search results to identify error origins and execution traces automatically, eliminating manual interpretation and enabling faster comprehension of complex code paths and dependencies.