New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Vexor CLI

by scarletkc in scarletkc/vexor

Semantic file discovery via vexor. An agent skill from scarletkc/vexor.

MITAuto-check passedAI & LLM Engineering

Install Vexor CLI

skills CLI
$ npx skills add scarletkc/vexor --skill vexor-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install scarletkc/vexor vexor-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/scarletkc/vexor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/vexor/skills/vexor-cli .claude/skills/vexor-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vexor-cli
GitHub stars
243
Used in
3 other repos
Token cost
~1.2k tokens
SKILL.md length
467 words
Files
2 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Semantic file discovery via vexor. An agent skill from scarletkc/vexor.

  • Locating where something is implemented/loaded/defined in a medium
  • SKILL.md covers Goal, Use It Like This, Command and Common Flags, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • The file location is unclear

What it does

Vexor CLI is an agent skill from scarletkc/vexor. 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.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/install-vexor.md`).

It sits in AI & LLM Engineering. It works with Model Context Protocol and Python. The repository describes itself as: A semantic search engine for files and code. The licence is MIT.

When your agent uses it

  • Locating where something is implemented/loaded/defined in a medium
  • The file location is unclear

Example prompts

  • “/vexor-cli”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 1d44ca4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vexor CLI loads about 1.2k tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 467 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from scarletkc/vexor at commit 1d44ca4, republished under its MIT licence (© scarletkc). 467 words, ~1,203 tokens.

Download SKILL.mdSave it as .claude/skills/vexor-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
vexor-cli
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.

Vexor CLI Skill

Goal

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

Use It Like This

Command

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

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
  • .vexorignore project rules always apply, even with --no-respect-gitignore.
  • --no-recursive: only the top directory
  • --format: rich (default), porcelain/porcelain-z for scripts, json for full output with chunk content
  • --content: print each match's source text below the table — usually removes the need to read the files afterwards
  • --no-cache: in-memory only, do not read/write index cache
  • vexor index --local: create and use project-local .vexor/ cache storage

Project Config

  • The nearest .vexor/config.json applies automatically for the resolved search or index path.
  • It accepts only rerank, auto_index, model, embedding_dimensions, batch_size, embed_concurrency, and extract_concurrency.
  • batch_size must be at least 0; both concurrency values must be at least 1.
  • Credentials and endpoints (api_key, base_url, remote_rerank) and all other fields are rejected.
  • Precedence is global config, project config, environment overrides, then explicit arguments.
  • vexor config --show labels each field's origin and vexor doctor lists active overrides; mutating vexor config commands remain global-only.

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)
Show full SKILL.md (206 more words)Show less

Troubleshooting

  • Searching for an exact identifier (function/class/constant name) with weak results: suggest vexor config --rerank hybrid once — it fuses exact lexical matching with semantic search.
  • 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 reports effective values and their origins.

Examples

bash
# Find CLI entrypoints / commands
vexor search "typer app commands" --top 5
bash
# Search docs by headings/sections
vexor search "user authentication flow" --path docs --mode outline --ext .md --format porcelain
bash
# Locate config loading/validation logic
vexor search "config loader" --path . --mode code --ext .py
bash
# Exclude tests and JavaScript files
vexor search "config loader" --path . --exclude-pattern tests/** --exclude-pattern .js
bash
# Read the matching code directly, without a follow-up file read
vexor search "where JWT claims are validated" --path . --mode code --content

Tips

  • First time search will index files (may take a minute). Long-lived MCP or Python client sessions reuse mapped vectors, monitor source changes, and skip some snapshot scans. Watcher setup failures fall back to scanning. Separate CLI invocations still validate the filesystem. Use longer timeouts if needed.
  • Results return similarity ranking, exact file location, line numbers, and matching snippet preview.
  • Add --content (or --format json) to get the matching source text in the same call, and skip reading those files separately. The text sits at content_start_line..content_end_line, which can begin later than the result's start_line when a long symbol was indexed as several chunks. If a result shows stale_line_range, the file changed since indexing — re-run vexor index. Content is capped per response, so lower-ranked results may report budget_exhausted.
  • Combine --ext with --exclude-pattern to focus on a subset (exclude rules apply on top).

© scarletkc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/vexor/skills/vexor-cli of scarletkc/vexor.

  • SKILL.md
  • references/install-vexor.md

Open the folder on GitHubat commit 1d44ca4

Used in 3 other repositories

We found 12 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in scarletkc/vexor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Vexor CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vexor CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vexor CLI this skillscarletkc/vexor2433 repos~1.2kAutomated safety check: PassMIT
Agent Squad Python Guide2FastLabs/agent-squad7.8k—~4.7kAutomated safety check: PassApache-2.0
ComfyUI Custom Node BuilderConstantineB6/comfy-pilot230—~897Automated safety check: PassMIT
Setupguaardvark/guaardvark2511 repos~1.2kAutomated safety check: PassMIT
Homepage Generatorwanshuiyin/ARIS-in-AI-Offer574—~4.8kAutomated safety check: NotesMIT
Sponsio Agent Safety SetupSponsioLabs/Sponsio440—~12kAutomated safety check: PassApache-2.0

Similar skills

  • Agent Squad Python Guide

    2FastLabs/agent-squad

    Map of the agent-squad Python framework for async multi-agent orchestration: which agent, classifier, storage and tool provider to pick, and the pitfalls to avoid.

    7.8k GitHub stars~4.7k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

  • ComfyUI Custom Node Builder

    ConstantineB6/comfy-pilot

    Helps an agent write ComfyUI custom nodes in Python, including wrapping an existing script, mapping data types and handling image batches.

    230 GitHub stars~897 tokensUpdated 7 mo ago
    AI & LLM EngineeringAuto-check passed

  • Setup

    guaardvark/guaardvark

    Connect this agent to a running Guaardvark (self-hosted AI studio) and check what it can do right now.

    251 GitHub starsUsed in 1 repo~1.2k tokens
    AI & LLM EngineeringAuto-check passed

  • Homepage Generator

    wanshuiyin/ARIS-in-AI-Offer

    Generate a fact-checked academic personal homepage from a CV, optionally augmented by an existing manual homepage and an assets directory.

    574 GitHub stars~4.8k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes

  • Sponsio Agent Safety Setup

    SponsioLabs/Sponsio

    Installs, tunes and enforces Sponsio contracts that block unsafe tool calls in LLM agents, covering setup, auditing, observe mode and flipping to enforce.

    440 GitHub stars~12k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

  • Gemini API Dev

    Ayuilos/Miffan

    A skill your agent uses when building applications with Gemini API hosted models, including Gemini and Gemma 4, working with multimodal content (text, images, audio, video), implementing function…

    182 GitHub starsUsed in 1 repo~1.4k tokens
    AI & LLM EngineeringAuto-check passed

Works with

Categories

Questions about Vexor CLI

What does Vexor CLI do?

Semantic file discovery via vexor. An agent skill from scarletkc/vexor. Vexor CLI is an agent skill from scarletkc/vexor. Semantic file discovery via vexor.

When should I use Vexor CLI?

Vexor CLI fits situations like: locating where something is implemented/loaded/defined in a medium; the file location is unclear.

How do I install Vexor CLI in Claude Code?

Run `npx skills add scarletkc/vexor --skill vexor-cli -a claude-code`. Or copy the skill folder (plugins/vexor/skills/vexor-cli in scarletkc/vexor) into .claude/skills/vexor-cli in your project. Claude Code loads it when a task matches its description.

How do I install Vexor CLI in Codex?

Run `npx skills add scarletkc/vexor --skill vexor-cli -a codex`. Or copy the skill folder (plugins/vexor/skills/vexor-cli in scarletkc/vexor) into .agents/skills/vexor-cli in your project. Codex loads it when a task matches its description.

Can I use Vexor CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add scarletkc/vexor --skill vexor-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vexor-cli, .gemini/skills/vexor-cli, .github/skills/vexor-cli and .opencode/skills/vexor-cli in your project.

What does Vexor CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: Vexor CLI is instructions for the agent only. Our summary lists: Python 3.

Does Vexor CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vexor CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vexor CLI use?

Vexor CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vexor CLI use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 312 tokens, read only when the agent opens those files.

What are the alternatives to Vexor CLI?

Skills that share tags, products or a category with Vexor CLI: Agent Squad Python Guide (2FastLabs/agent-squad, 7.8k stars), ComfyUI Custom Node Builder (ConstantineB6/comfy-pilot, 230 stars), Setup (guaardvark/guaardvark, 251 stars) and Homepage Generator (wanshuiyin/ARIS-in-AI-Offer, 574 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vexor CLI?

scarletkc (a GitHub user) maintains it in scarletkc/vexor, which has 243 GitHub stars. The repository was last updated on October 2, 2026.

Source: scarletkc/vexor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.