AGENT SKILL

vexor-cli

Semantic file discovery via `vexor`. Use whenever locating where something is implemented/loaded/defined in a medium or large repo, or when the file location is unclear. Prefer this over manual browsing.

License 许可
MIT
最近更新
2026-05-10
Stars
★ 1
Forks
1

01 前言 Front Matter

name
vexor-cli
risk
unknown
source
community
description
Semantic file discovery via `vexor`. Use whenever locating where something is implemented/loaded/defined in a medium or large repo, or when the file location is unclear. Prefer this over manual browsing.

03 SKILL.md 正文

Vexor CLI Skill

When to Use

  • You need to locate files by intent rather than exact filename or text match.
  • The repository is large enough that manual browsing or naive grep is too slow or ambiguous.
  • You want semantic discovery of where something is implemented, loaded, defined, or documented.

Goal

Find files by intent (what they do), not exact text.

Use It Like This

  • Use vexor first for intent-based file discovery.
  • If vexor is missing, follow references/install-vexor.md.

Command

vexor "<QUERY>" [--path <ROOT>] [--mode <MODE>] [--ext .py,.md] [--exclude-pattern <PATTERN>] [--top 5] [--format rich|porcelain|porcelain-z]

Common Flags

  • --path/-p: root directory (default: current dir)
  • --mode/-m: indexing/search strategy
  • --ext/-e: limit file extensions (e.g., .py,.md)
  • --exclude-pattern: exclude paths by gitignore-style pattern (repeatable; .js → **/*.js)
  • --top/-k: number of results
  • --include-hidden: include dotfiles
  • --no-respect-gitignore: include ignored files
  • --no-recursive: only the top directory
  • --format: rich (default) or porcelain/porcelain-z for scripts
  • --no-cache: in-memory only, do not read/write index cache

Modes (pick the cheapest that works)

  • auto: routes by file type (default)
  • name: filename-only (fastest)
  • head: first lines only (fast)
  • brief: keyword summary (good for PRDs)
  • code: code-aware chunking for .py/.js/.ts (best default for codebases)
  • outline: Markdown headings/sections (best for docs)
  • full: chunk full file contents (slowest, highest recall)

Troubleshooting

  • Need ignored or hidden files: add --include-hidden and/or --no-respect-gitignore.
  • Scriptable output: use --format porcelain (TSV) or --format porcelain-z (NUL-delimited).
  • Get detailed help: vexor search --help.
  • Config issues: vexor doctor or vexor config --show diagnoses API, cache, and connectivity (tell the user to set up).

Examples

# Find CLI entrypoints / commands
vexor search "typer app commands" --top 5
# Search docs by headings/sections
vexor search "user authentication flow" --path docs --mode outline --ext .md --format porcelain
# Locate config loading/validation logic
vexor search "config loader" --path . --mode code --ext .py
# Exclude tests and JavaScript files
vexor search "config loader" --path . --exclude-pattern tests/** --exclude-pattern .js

Tips

  • First time search will index files (may take a minute). Subsequent searches are fast. Use longer timeouts if needed.
  • Results return similarity ranking, exact file location, line numbers, and matching snippet preview.
  • Combine --ext with --exclude-pattern to focus on a subset (exclude rules apply on top).

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

04 同仓库更多 Skills

Sansar35
Sansar35/claude-agent

zustand-store-ts

Create Zustand stores following established patterns with proper TypeScript types and middleware.

★ 1
Sansar35
Sansar35/claude-agent

zod-validation-expert

Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.

★ 1
Sansar35
Sansar35/claude-agent

zinc-database

Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.

★ 1
Sansar35
Sansar35/claude-agent

zarr-python

Chunked N-D arrays for cloud storage. Compressed arrays, parallel I/O, S3/GCS integration, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.

★ 1
Sansar35
Sansar35/claude-agent

zapier-workflows

Manage and trigger pre-built Zapier workflows and MCP tool orchestration. Use when user mentions workflows, Zaps, automations, daily digest, research, search, lead tracking, expenses, or asks to "run" any process. Also handles Perplexity-based research and Google Sheets data tracking.

★ 1
Sansar35
Sansar35/claude-agent

zapier-make-patterns

No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points. This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power

★ 1