file-suggestion

Search project files with fuzzy matching using rg and fzf.

1|2|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/addisonk/claude-code-skills --skill file-suggestion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-suggestion
Source: https://github.com/addisonk/claude-code-skills/tree/main/dev-tools/file-suggestion
Command: npx skills add https://github.com/addisonk/claude-code-skills --skill file-suggestion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fzf, ripgrep, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a significantly faster and more intelligent way to find files within your project, overcoming the limitations of basic file searching.

Core Features & Use Cases

  • Fuzzy File Matching: Quickly locate any file using partial or misspelled names.
  • Symlink and Gitignore Awareness: Accurately searches through symlinks and respects your .gitignore rules.
  • Use Case: When you need to quickly open a configuration file whose exact name you don't remember, you can use this skill to fuzzy search for it and open it in seconds.

Quick Start

Use the file suggestion skill to find the file named 'claude-config.json'.

Frequently Asked Questions about file-suggestion

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

FAQPage Schema
How do I do fuzzy file search in a large codebase from the command line?

Fuzzy file search in a large codebase is enabled by using ripgrep and fzf to quickly locate files by partial or misspelled names. This approach provides a command-line interface for rapid file retrieval.

Does file search with ripgrep respect my .gitignore rules?

Yes, file search with ripgrep respects .gitignore rules to ensure accurate results. It also supports following symlinks, preventing ignored files from cluttering your search output.

What's the best way to find a config file when I only remember part of the name?

The best way to find a config file by partial name is using fuzzy file matching. This allows you to quickly locate and open files even when you do not remember their exact names.

Do I need to install fzf and ripgrep to use this file search skill?

Yes, you need to install fzf, ripgrep, and jq as dependencies. These command-line tools provide the underlying fuzzy finding and searching capabilities required by the skill.

How does fuzzy finding handle symlinks during a project directory search?

Fuzzy finding handles symlinks by explicitly supporting symlink following during the search. This ensures that linked directories and files are included in your search results accurately.