Communitygithub.com

petr-korobeinikov/skills

Habilidades para o agente Claude Code. Markdown simples. Altamente opinativas.

O que é skills?

Esta habilidade ensina o agente Claude Code a preferir `fd` em vez de `find` para buscas no sistema de arquivos. `fd` é significativamente mais rápido em diretórios grandes, possui padrões mais sensatos (como respeitar `.gitignore`, uso inteligente de maiúsculas/minúsculas e regex por padrão) e uma CLI mais ergonômica. A habilidade cobre desde substituições diretas de comandos `find` por `fd`, expressões idiomáticas comuns (como busca por extensão, globs, busca no caminho completo e execução paralela com `-x`), até armadilhas importantes, como o fato de o primeiro argumento posicional ser o padrão e não o caminho, e o comportamento padrão de excluir entradas ocultas. A documentação também inclui um fallback para `find` quando `fd` não está disponível (por exemplo, em imagens mínimas de CI), com um exemplo de código, e instruções de instalação para várias distribuições Linux e macOS. A habilidade é aplicável a qualquer invocação de shell que busque no sistema de arquivos, incluindo ferramentas Bash, scripts, Makefiles e configurações de CI.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add petr-korobeinikov/skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

fd

Prefira fd a find para buscas no sistema de arquivos. fd é mais rápido em árvores grandes, tem padrões mais sensatos (respeita .gitignore, uso inteligente de maiúsculas/minúsculas, regex por padrão), e uma CLI mais ergonômica.

Documentação oficial: https://github.com/sharkdp/fd (README + fd --help). Verifique qualquer forma não trivial contra o manual antes de confiar nela.

Porquê

  • Travessia paralela de diretórios — notavelmente mais rápido que find em repositórios grandes.
  • Padrões sensatos prontos para uso: entradas ocultas ignoradas, .gitignore / .ignore / .fdignore respeitados quando dentro de um repositório git, uso inteligente de maiúsculas/minúsculas (sem distinção, a menos que o padrão tenha uma letra maiúscula), padrões são regex por padrão.
  • O padrão corresponde ao nome do arquivo por padrão, não ao caminho completo — fd foo faz o que find . -iname '*foo*' faz, sem o ritual de curingas e aspas.
  • Execução paralela -x, saída separada por nulo (-0), e um único conjunto de opções que se compõem sem ginástica de -print/-prune.

Regra

fd PADRÃO [CAMINHO]

O primeiro argumento posicional é o padrão; o segundo é a raiz da busca (padrão é o diretório atual). Um primeiro argumento em forma de caminho (contendo /) não é um caminho — use fd . CAMINHO ou fd --full-path PADRÃO.

Substituições diretas

Não useUse
find . -name 'foo*'fd '^foo'
find . -iname '*.md'fd -e md
find . -type f -name foofd -t f foo
find . -type d -name node_modulesfd -t d node_modules
find . -type lfd -t l
find . -name '*.txt' -deletefd -e txt -X rm
find . -name '*.txt' -exec rm {} \;fd -e txt -x rm
find . -name node_modules -prunefd -E node_modules
find . -size +100Mfd -S +100mi
find . -mtime -7fd --changed-within 7d
find . -mtime +7fd --changed-before 7d
find . -name '*.go' -print0 | xargs -0 wc -lfd -e go -0 | xargs -0 wc -l
find /etc -name passwdfd passwd /etc
find / -name foofd -u foo /

Para uma correspondência exata com find -size, use os sufixos binários (ki, mi, gi) — -S +100m é 100 * 10^6 bytes, -S +100mi é 100 * 2^20 bytes.

Para buscas com find / que também devem descer em diretórios ocultos e .gitignore, adicione -u(atalho para--no-ignore --hidden`).

Expressões idiomáticas

Correspondência por extensão (uma ou várias):

fd -e md
fd -e h -e cpp

Modo glob para padrões no estilo shell (-g para que ** e * signifiquem o usual):

fd -g '**/*.test.ts'
fd -g 'libc.so' /usr

Correspondência contra o caminho completo, não apenas o nome do arquivo:

fd --full-path 'src/.*\.proto$'

Incluir entradas ocultas (.git, .vscode, etc.) mas manter as regras de .gitignore:

fd -H pre-commit

Desconsiderar regras de .gitignore mas manter entradas ocultas ocultas:

fd -I node_modules

Buscar em todos os lugares — tanto ocultos quanto ignorados:

fd -u PADRÃO

Excluir caminhos (sintaxe glob, substitui toda regra de ignore, repetível):

fd -E .git -E '*.bak' PADRÃO

Limitar profundidade:

fd -d 2 -t d

Combinar múltiplos padrões obrigatórios (todos devem corresponder ao nome do arquivo, regex por padrão):

fd 'foo' --and 'bar' --and 'baz'

Executar por resultado (paralelo, substituição {}, sem terminador \;):

fd -e jpg -x convert {} {.}.png

Executar uma vez com todos os resultados como argumentos (ferramentas em lote como wc, clang-format, rg):

fd -e rs -X wc -l

Encanar saída separada por nulo para outras ferramentas:

fd -e go -0 | xargs -0 wc -l

Armadilhas

  • O primeiro argumento posicional é o padrão, não o caminho. fd /etc/passwd interpreta /etc/passwd como uma regex com / e gera erro com a sugestão de usar fd . /etc/passwd ou --full-path.
  • A busca padrão exclui entradas ocultas e respeitadas por .gitignore. Ao procurar algo dentro de node_modules ou .git, adicione -H -I (ou -u) ou a lista de resultados estará vazia pelo motivo errado.
  • --exec paraleliza por padrão. A ordem da saída é não determinística. Passe -j 1 (ou --threads 1) quando a execução serial for necessária.
  • Padrões são regex por padrão. Um . simples corresponde a qualquer caractere; para um .foo literal, ancore-o ('\.foo$') ou passe -F/--fixed-strings.
  • Sufixos de tamanho são decimais SI por padrão. -S +100m é 100 MB (10^6 bytes por m); use mi/ki/gi para unidades binárias ao corresponder exatamente à semântica de find -size.

Fallback para find

fd nem sempre está disponível — imagens mínimas de CI, servidores bloqueados, imagens base de contêiner sem pacotes extras. Teste com command -v e recorra a find:

if command -v fd >/dev/null; then
  fd -e log -t f -X rm
else
  find . -type f -name '*.log' -exec rm {} +
fi

Para um snippet único em um ambiente local controlado, use fd diretamente. Mude para find incondicionalmente apenas quando o host alvo for conhecido por não ter fd (por exemplo, um contêiner Alpine mínimo sem fd na imagem).

Não instale fd automaticamente apenas para satisfazer esta habilidade — o fallback é a resposta correta quando ele está ausente.

Instalando fd

  • macOS: brew install fd
  • Debian/Ubuntu: apt install fd-find — o binário se chama fdfind para evitar conflito de nomes (alias fd=fdfind é a solução padrão).
  • Fedora: dnf install fd-find
  • Arch: pacman -S fd
  • Alpine: apk add fd
  • Binários pré-compilados e outras plataformas: https://github.com/sharkdp/fd/releases

Quando o mise gerencia as ferramentas do host, o nome curto do registro fd resolve para aqua:sharkdp/fd — instale com mise use -g fd@<versão> (fixado, conforme a habilidade mise do projeto). Não use o backend ubi: — a habilidade mise o desabilita.

Escopo

Aplica-se sempre que um snippet de shell pesquisa o sistema de arquivos:

  • Invocações da ferramenta Bash.
  • Snippets em SKILL.md / README.md / docs.
  • Scripts em scripts/.
  • Receitas de Makefile.
  • Configurações de CI.
  • Instruções de instalação.

Se você encontrar uma invocação de find enquanto edita um arquivo, substitua-a pela forma equivalente de fd (mais o fallback find quando o snippet precisar ser executado em um host que pode não ter fd) como parte da mesma edição.

Habilidades Relacionadas