smart-explore

Outline codebases, search symbols across files, and unfold function bodies via AST.

35|5|Updated Jul 5, 2025
One-click install
npx skills add https://github.com/alexei-led/cc-thingz --skill smart-explore-alexei-led
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-explore
Source: https://github.com/alexei-led/cc-thingz/tree/main/plugins/dev-tools/skills-codex/smart-explore
Command: npx skills add https://github.com/alexei-led/cc-thingz --skill smart-explore-alexei-led

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Token-efficient code navigation via AST parsing helps developers explore large codebases with fewer tokens.

Core Features & Use Cases

  • Outline the code structure quickly using smart_outline to reveal the project's architectural layout without loading full files.
  • Discover symbols across files with smart_search to locate definitions, references, and related entities.
  • Retrieve exact function bodies and types using smart_unfold based on an AST node or symbol, ensuring complete context.
  • Real-world scenario: On a massive repository, quickly map modules, locate a function, and inspect its body without scanning every file.

Quick Start

Outline the codebase with smart_outline, then search for a symbol with smart_search, and finally unfold the target function with smart_unfold.

Frequently Asked Questions about smart-explore

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

FAQPage Schema
How do I navigate a large codebase without loading full files?

AST-based code navigation allows you to explore large codebases efficiently by outlining project structure and unfolding specific functions without loading full files. This minimizes token usage while preserving complete function bodies.

What is AST-based outlining for code exploration?

AST-based outlining is a technique that reveals a project's architectural layout by parsing code structure without loading full files. It provides a high-level structural view of modules and functions, enabling efficient code exploration.

How do I find symbol definitions across multiple files?

Cross-file symbol discovery allows you to locate definitions, references, and related entities across multiple files. By searching with AST-based tools, you can pinpoint exact symbols without manually scanning every file in the repository.

Can I retrieve exact function bodies using AST analysis?

Yes, AST analysis allows you to retrieve exact function bodies and types by unfolding specific AST nodes or symbols. This ensures you capture the complete function context without truncation during code exploration.

Does AST-based code navigation work for onboarding to massive repositories?

AST-based code navigation is well-suited for onboarding to massive repositories. It enables software engineers to quickly map modules, locate target functions, and inspect their bodies without scanning every file, reducing token consumption.

What is the best way to explore code structure without consuming too many tokens?

The best way to explore code structure with minimal tokens is using an outline-search-unfold workflow. You first outline the project layout, search for specific symbols across files, and then unfold only the target functions you need.