fuzzy-selecting

name	fuzzy-selecting
description	Use when choosing interactively from search results, files, processes, or any command output with preview capabilities

fzf: Interactive Fuzzy Finder

Always invoke fuzzy-selecting 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 fuzzy-selecting 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 (finding-files, searching-text, querying-json, querying-yaml) → fuzzy-selecting skill → other skills (viewing-files, 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

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

• finding-files → fuzzy-selecting: Interactive file selection from search results
• searching-text → fuzzy-selecting: Interactive selection from search matches
• querying-json/querying-yaml → fuzzy-selecting: Interactive selection from extracted data
• git log/branch → fuzzy-selecting: Interactive git history browsing

For Analysis Phase

• any_command → fuzzy-selecting → viewing-files: Select items and preview with syntax highlighting
• finding-files → fuzzy-selecting --preview="bat {}": File browser with syntax preview
• searching-text → fuzzy-selecting --preview="bat {1} +{2}": Search results with file preview

For Refactoring Phase

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

Integration Examples

# 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