code-explore

Construct vector-optimized queries using AST-based code analysis and semantic codebase packaging.

1|Updated Dec 17, 2016
One-click install
npx skills add https://github.com/vm-wylbur/pb-dotfiles --skill code-explore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-explore
Source: https://github.com/vm-wylbur/pb-dotfiles/tree/main/ai/claude-code/skills/code-explore
Command: npx skills add https://github.com/vm-wylbur/pb-dotfiles --skill code-explore

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually exploring large codebases with basic filesystem tools (grep, find, Read) is slow, token-inefficient, and lacks semantic understanding. This leads to wasted time, incomplete analysis, and difficulty in understanding complex code.

Core Features & Use Cases

  • AST-Based Analysis (Tree-Sitter): Precisely extract functions, classes, imports, trace usage, and analyze complexity with language-aware parsing, eliminating false positives from comments or strings.
  • Semantic Codebase Packaging (Repomix): Efficiently search entire codebases for patterns, idioms, and structural information, with built-in security validation and token optimization for large projects.
  • Intelligent Tool Routing: Automatically selects the optimal tool (Tree-Sitter for semantic understanding or Repomix for pattern matching) for each exploration task, ensuring maximum efficiency and accuracy.
  • Use Case: Instead of manually greping for "CopyWorker" across multiple files, you can ask "Where is CopyWorker class used?". The skill will use tree-sitter find_usage to instantly provide all usage locations with file:line references, saving significant time and tokens.

Quick Start

Explore the project structure. The skill will use tree-sitter analyze_project to provide a structured overview of the codebase.

Frequently Asked Questions about code-explore

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

FAQPage Schema
How do I explore a large codebase without manually grepping through files?

Semantic code exploration uses Tree-Sitter AST parsing and Repomix to automatically extract functions, classes, imports, and usage patterns across your entire codebase. Instead of manual grep commands, you get structured results with file:line references, eliminating false positives from comments or strings.

Can I find where a specific class or function is used across my project?

Yes. Tree-Sitter find_usage traces all references to a symbol—like CopyWorker—across multiple files instantly, returning exact locations with line numbers. This replaces time-consuming manual searching with language-aware semantic analysis.

What's the difference between Tree-Sitter and traditional grep for code analysis?

Tree-Sitter performs Abstract Syntax Tree parsing to understand code structure semantically, eliminating false matches in comments, strings, or unrelated contexts. Grep searches text literally and lacks language awareness, leading to incomplete or incorrect results on complex codebases.

How do I get a structured overview of my project's codebase?

Use tree-sitter analyze_project to generate a structured summary of your codebase organization, including functions, classes, imports, and complexity metrics. This provides instant insights into your project architecture without token-inefficient manual exploration.

Does this tool work with large projects, or will it hit token limits?

Repomix is built for large-project efficiency with token optimization and built-in security validation. It packages entire codebases for pattern matching while managing token consumption, making it suitable for exploration at scale without exhausting context windows.

Can I use semantic analysis to find patterns and idioms across my codebase?

Yes. Repomix enables efficient pattern and idiom matching across entire codebases by semantically packaging code structure. Combined with Tree-Sitter's AST awareness, you can search for architectural patterns and structural information precisely.