What dependencies are required to use this skill?

You will need sqlite3, python3, and jq installed on your system for the optimization script to function correctly.

How often is the file index updated?

The index is automatically rebuilt every 5 minutes and cached per-repository to ensure your file suggestions remain accurate without manual intervention.

How much faster is this compared to the default Claude Code search?

Benchmark tests show a reduction in query time from 28ms to approximately 3ms, offering a 9x performance improvement for file discovery.

Does it respect my project's .gitignore file?

Yes, the skill utilizes 'git ls-files' to build its index, ensuring that ignored files and build artifacts do not clutter your suggestions.

Where is the index data stored?

The search index is stored locally on your machine within the ~/.cache/claude-code/ directory, organized by repository.

Performance File Suggestions

Name: Performance File Suggestions
Author: spences10

byspences10

•

Productivity & Workflow

Optimizes Claude Code file discovery with lightning-fast SQLite FTS5 indexing and intelligent relevance ranking.

This skill significantly boosts the responsiveness of Claude Code by replacing the default file suggestion mechanism with a high-performance SQLite FTS5 full-text search engine. By indexing project files and implementing BM25 ranking, it reduces query times by up to 90%, making it an essential optimization for developers working in large-scale repositories where instant file navigation is critical for maintaining flow.

Key Features

01Native git ls-files integration to respect .gitignore rules

023 GitHub stars

03Intelligent BM25 ranking for relevance-based suggestions

04Automatic index caching with 5-minute background refreshes

05Significant latency reduction from 28ms to 3ms per query

06SQLite FTS5 full-text indexing for rapid file retrieval

Use Cases

01Navigating massive codebases where default file search feels sluggish

02Improving AI responsiveness during complex cross-file refactoring tasks

03Optimizing local development environments for low-latency command execution

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add spences10/claude-code-toolkit performance

For use in Claude.ai and ChatGPT

Download Skill