Fd Find

A fast and user-friendly alternative to 'find' - simple syntax, smart defaults, respects gitignore.

Security Scan

The skill is an instruction-only wrapper for the fd file-finder tool; its requirements and install hints match its stated purpose and it does not request extra credentials or unusual privileges.

Purpose & Capability

The name/description (fd - fast file finder) match the SKILL.md content. The instructions exclusively show usage of fd and common Unix tools. The SKILL.md metadata sensibly declares the fd binary and provides platform-appropriate install hints (brew formula 'fd', apt package 'fd-find').

Instruction Scope

Instructions stay within the tool's scope (searching and operating on files). They include examples that run arbitrary commands on results (rm, cp, convert, xargs, -x) — this is expected for a find/ fd helper but is potentially destructive if executed unintentionally. The skill does not instruct reading unrelated system files or environment variables.

Install Mechanism

This is instruction-only (no code files). The embedded install hints use well-known package managers (Homebrew and apt) and package names that match the project; no downloads from untrusted URLs or extraction of arbitrary archives are present.

Credentials

The skill declares no required environment variables, credentials, or config paths and the instructions do not reference any secrets or unrelated environment variables.

Persistence & Privilege

The skill does not request always-on inclusion; default autonomous invocation is permitted by platform policy but the skill itself does not elevate privileges or modify other skills or system-wide settings.

Assessment

This skill is coherent and matches the fd utility. It's instruction-only and asks for nothing sensitive. Before installing/using: (1) be aware examples include destructive commands (rm -x, xargs rm) — only run commands you trust; (2) installing via apt may require sudo on Linux; (3) confirm you want the agent to run shell commands (if you restrict autonomous actions, avoid allowing the agent to invoke skills that execute destructive commands without explicit confirmation). If you only need help with examples/docs, no install or credentials are required.

fd - Fast File Finder

User-friendly alternative to find with smart defaults.

Quick Start

Basic search

# Find files by name
fd pattern

# Find in specific directory
fd pattern /path/to/dir

# Case-insensitive
fd -i pattern

Common patterns

# Find all Python files
fd -e py

# Find multiple extensions
fd -e py -e js -e ts

# Find directories only
fd -t d pattern

# Find files only
fd -t f pattern

# Find symlinks
fd -t l

Advanced Usage

Filtering

# Exclude patterns
fd pattern -E "node_modules" -E "*.min.js"

# Include hidden files
fd -H pattern

# Include ignored files (.gitignore)
fd -I pattern

# Search all (hidden + ignored)
fd -H -I pattern

# Maximum depth
fd pattern -d 3

Execution

# Execute command on results
fd -e jpg -x convert {} {.}.png

# Parallel execution
fd -e md -x wc -l

# Use with xargs
fd -e log -0 | xargs -0 rm

Regex patterns

# Full regex search
fd '^test.*\.js$'

# Match full path
fd --full-path 'src/.*/test'

# Glob pattern
fd -g "*.{js,ts}"

Time-based filtering

# Modified within last day
fd --changed-within 1d

# Modified before specific date
fd --changed-before 2024-01-01

# Created recently
fd --changed-within 1h

Size filtering

# Files larger than 10MB
fd --size +10m

# Files smaller than 1KB
fd --size -1k

# Specific size range
fd --size +100k --size -10m

Output formatting

# Absolute paths
fd --absolute-path

# List format (like ls -l)
fd --list-details

# Null separator (for xargs)
fd -0 pattern

# Color always/never/auto
fd --color always pattern

Common Use Cases

Find and delete old files:

fd --changed-before 30d -t f -x rm {}

Find large files:

fd --size +100m --list-details

Copy all PDFs to directory:

fd -e pdf -x cp {} /target/dir/

Count lines in all Python files:

fd -e py -x wc -l | awk '{sum+=$1} END {print sum}'

Find broken symlinks:

fd -t l -x test -e {} \; -print

Search in specific time window:

fd --changed-within 2d --changed-before 1d

Integration with other tools

With ripgrep:

fd -e js | xargs rg "pattern"

With fzf (fuzzy finder):

vim $(fd -t f | fzf)

With bat (cat alternative):

fd -e md | xargs bat

Performance Tips

• fd is typically much faster than find
• Respects .gitignore by default (disable with -I)
• Uses parallel traversal automatically
• Smart case: lowercase = case-insensitive, any uppercase = case-sensitive

Tips

• Use -t for type filtering (f=file, d=directory, l=symlink, x=executable)
• -e for extension is simpler than -g "*.ext"
• {} in -x commands represents the found path
• {.} strips the extension
• {/} gets basename, {//} gets directory

Documentation

GitHub: https://github.com/sharkdp/fd Man page: man fd