convez.ai
SkillBusca & PesquisaIntermediário
netresearch

File Search Skill

netresearch/file-search-skill

Busca rápida e estruturada em codebases com ferramentas CLI otimizadas

Ver no GitHub
BomPluginScore · de 0 a 100

Skill para Claude Code que ensina estratégias eficientes de busca em código e arquivos via CLI. Fornece orientação sobre seleção de ferramentas (ripgrep, ast-grep, fd, rga, tokei, semgrep), padrões prontos e boas práticas para pesquisar bases de código de qualquer tamanho.

Instalação

$npx convez-ai netresearch/file-search-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
46
Forks
5
Acompanhando
1
Saúde
100%
Último commit
há 2 dias
Versão
v1.8.4
Issues abertas
2
Contribuidores
3

Casos de uso

  • Pesquisar padrões de código em grandes repositórios
  • Encontrar vulnerabilidades e problemas de segurança com análise estruturada
  • Contar linhas de código e obter estatísticas por linguagem
  • Localizar arquivos específicos e extrair texto de PDFs/documentos

Veredito

Skill bem estruturado que capacita busca inteligente em código via linha de comando. Ideal para desenvolvedores que trabalham com bases grandes; documentação clara sobre quando usar cada ferramenta torna-o prático mesmo para iniciantes em CLI tools.

README

A tradução para o português deste README ainda está na fila.

File Search Skill

CI Release License OpenSSF Scorecard

An AI agent skill that teaches efficient CLI-based code and file search strategies. Provides tool selection guidance, pattern recipes, and best practices for searching codebases of any size.

Tools Covered

ToolPurposeReplaces
ripgrep (rg)Ultra-fast text/regex searchgrep, grep -r
ast-grep (sg)Structural/syntax-aware code searchcomplex regex hacks
semgrep (semgrep)Security/lint rules at scale with taint analysishand-rolled regex CI checks
fd (fd)Fast file finderfind
ripgrep-all (rga)Search PDFs, Office docs, archivesmanual text extraction
tokeiFast code statistics by languagecloc, wc -l
sccCode counter with complexity analysiscloc, tokei (when complexity needed)

Key Principles

  • Use rg instead of grep for text search in source code
  • Use fd instead of find for file discovery
  • Use rga instead of rg when searching non-code files (PDFs, Office docs, archives)
  • Use sg instead of regex when matching code structure
  • Use semgrep when you want a catalog of security/lint rules (taint, registry) — not just a single pattern
  • Use tokei or scc to assess codebase size, not cloc or wc -l
  • Always start with targeted, narrow searches and widen only if needed
  • Always specify file types/languages to limit search scope
  • Count matches before viewing full results to avoid overwhelming output

Installation

Marketplace (Recommended)

Add the Netresearch marketplace once, then browse and install skills:

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace

npx (skills.sh)

Install with any Agent Skills-compatible agent:

npx skills add https://github.com/netresearch/file-search-skill --skill file-search

Download Release

Download the latest release and extract to your agent's skills directory.

Git Clone

git clone https://github.com/netresearch/file-search-skill.git

Composer (PHP Projects)

composer require netresearch/file-search-skill

Requires netresearch/composer-agent-skill-plugin.

npm (Node Projects)

npm install --save-dev \
  @netresearch/agent-skill-coordinator \
  github:netresearch/file-search-skill

Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, also allowlist the coordinator's postinstall:

{
  "pnpm": {
    "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
  }
}

Skill Structure

skills/file-search/
  SKILL.md                          # Main skill file (tool selection, usage, best practices)
  evals/
    evals.json                      # Evaluation definitions for testing skill effectiveness
  references/
    ripgrep-patterns.md             # Extensive rg pattern recipes by use case
    ast-grep-patterns.md            # Structural search patterns by language
    semgrep-patterns.md             # Security/lint rules, taint mode, registry
    fd-guide.md                     # fd file finder guide
    rga-guide.md                    # ripgrep-all for non-code files
    tool-comparison.md              # Detailed comparison and decision guide
    search-strategies.md            # Search targeting strategies
    code-metrics.md                 # tokei/scc code statistics guide
    remote-handoff.md               # When to hand off to remote tools

License

This project uses split licensing:

  • Code (scripts, workflows, configs): MIT
  • Content (skill definitions, documentation, references): CC-BY-SA-4.0

See the individual license files for full terms.

Ver o original no GitHub

Bom para

Relacionados