Agent skill

fuzzy-selecting

Provides interactive fuzzy finder for selecting items from any list with preview capabilities. Use this skill when choosing from search results, files, processes, or any command output

View SKILL.md on GitHub Repository
Stars 8
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/iota9star/my-skills/tree/main/skills/fzf

SKILL.md

fzf: Interactive Fuzzy Finder

Always invoke fzf skill for interactive fuzzy selection - do not execute bash commands directly.

Use fzf for interactive fuzzy selection and filtering of any command-line list.

Default Strategy

Invoke fzf skill for interactive fuzzy selection from any list with preview capabilities. Use when choosing from search results, files, processes, or any command output.

Common workflow: Discovery skill (fd, ripgrep, jq, yq) → fzf skill → other skills (bat, xargs) for interactive selection and action.

Key Options

Display Modes

  • --height N[%] set height (percent or exact lines)
  • --tmux [POS][SIZE][,border] tmux popup mode
  • --layout default|reverse|reverse-list layout direction
  • --border [rounded|sharp|thin] add border
  • --style default|full|minimal UI preset

Search & Matching

  • -e/--exact exact matching instead of fuzzy
  • --scheme default|path|history input type optimization
  • --delimiter STR custom field delimiter
  • --nth N.. search specific fields only

Preview Window

  • --preview "CMD {}" external command preview
  • --preview-window POSITION[SIZE][,border] preview configuration
  • --preview-label TEXT custom preview label

Selection Options

  • -m/--multi multi-select mode (TAB to mark)
  • --bind KEY:ACTION custom key bindings
  • --prompt "TEXT" custom prompt string
  • --header "TEXT" custom header text

Performance Options

  • --tac reverse input order (top-down)
  • --with-nth N.. display specific fields
  • --ansi parse ANSI color codes

When to Use

  • File Selection: Interactive file browsing with preview
  • Command History: Search and reuse previous commands
  • Process Management: Select and manage running processes
  • Git Integration: Browse commits, branches, files
  • Multi-Select Operations: Batch processing of selected items

Common Workflows

  • fd | fzf → bat: Find files, select, view with syntax highlighting
  • ripgrep | fzf → vim: Search content, select matches, edit files
  • jq/yq | fzf → bat: Extract data, select entries, view details
  • git log | fzf → show: Browse commits, select, view changes
  • ps | fzf → kill: List processes, select, terminate
  • find | fzf -m → xargs: Multiple selection for batch operations

Core Principles

  1. Interactive Filtering: Real-time fuzzy matching as you type
  2. Universal Input: Works with any list from STDIN or file system
  3. Extensible: Customizable through bindings and preview commands
  4. Performance: Optimized to handle millions of items instantly

Detailed Reference

For comprehensive search patterns, key bindings, preview configurations, and integration examples, load fzf guide when needing:

  • Custom key bindings and actions
  • Advanced preview window configuration
  • Multi-select workflows
  • Tmux integration
  • Shell setup functions

The guide includes:

  • Basic usage and display modes
  • Search syntax and matching patterns
  • Multi-select operations and key bindings
  • Preview window configuration
  • Integration examples (git, processes, file systems)
  • Performance optimization and troubleshooting
  • Shell integration setup and custom functions

Skill Combinations

For Discovery Phase

  • fd → fzf: Interactive file selection from search results
  • ripgrep → fzf: Interactive selection from search matches
  • jq/yq → fzf: Interactive selection from extracted data
  • git log/branch → fzf: Interactive git history browsing

For Analysis Phase

  • any_command → fzf → bat: Select items and preview with syntax highlighting
  • fd → fzf --preview="bat {}": File browser with syntax preview
  • ripgrep → fzf --preview="bat {1} +{2}": Search results with file preview

For Refactoring Phase

  • any_command → fzf -m: Batch process multiple selected items
  • find | fzf -m | xargs: Classic multi-select pattern
  • ps | fzf -m | xargs kill: Multi-process management

Integration Examples

bash
# Interactive code search and edit
rg "pattern" | fzf --preview="bat --color=always --highlight-line {2} {1}" | awk '{print $1}' | xargs vim

# Interactive dependency management
jq -r '.dependencies | keys[]' package.json | fzf --multi | xargs npm uninstall

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

iota9star/my-skills

analyzing-code

Analyzes code statistics by language for project insight, CI/CD metrics, or before refactoring. Use this skill when understanding project composition, measuring change impact, or generating CI/CD metrics

8 0
Explore
iota9star/my-skills

querying-json

Extracts specific fields from JSON files efficiently using jq instead of reading entire files, saving 80-95% context. Use this skill when querying JSON files, filtering/transforming data, or getting specific field(s) from large JSON files

8 0
Explore
iota9star/my-skills

extracting-code-structure

Extracts file structure (functions, classes, exports) efficiently without reading entire files, using ast-grep, Dart/Flutter analyzer, ctags, or other language-specific tools to get outlines and signatures. Use this skill when listing all methods, functions, or classes in a file, exploring unfamiliar code, getting API overviews, or deciding what to read selectively

8 0
Explore
iota9star/my-skills

querying-yaml

Extracts specific fields from YAML files efficiently using yq instead of reading entire files, saving 80-95% context. Use this skill when querying YAML files, filtering/transforming configuration data, or getting specific field(s) from large YAML files like docker-compose.yml or GitHub Actions workflows

8 0
Explore
iota9star/my-skills

replacing-text

Provides intuitive find & replace CLI with JavaScript regex and string-literal mode. Use this skill when performing text replacements, batch transformations, or need JavaScript-style regex syntax

8 0
Explore
iota9star/my-skills

analyzing-code-structure

Performs structural code search and refactoring by matching code structure instead of exact text. Use when editing code structure with text matching ambiguity, handling "old_string not unique" problems, or performing formatting-independent pattern matching across function signatures, method calls, and class structures

8 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results