fux-usage

Resolves the fux CLI and routes queries to the correct search verb.

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/arpitarya/fux --skill fux-usage-arpitarya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fux-usage
Source: https://github.com/arpitarya/fux/tree/main/.agents/skills/fux-usage
Command: npx skills add https://github.com/arpitarya/fux --skill fux-usage-arpitarya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents frequently fail to run the fux documentation index because the CLI is not on PATH, then silently fall back to grep or invent answers. This Skill ensures the fux command is resolved correctly from any environment and that queries use the right verb with structured JSON output. ## Core Features & Use Cases - Command Resolution Ladder: Probes four invocations (fux, uv run fux, ./.venv/bin/fux, python -m fux) with --version to find a working CLI without activating virtualenvs or installing anything. - Verb Selection: Routes questions to ask, find, answer, explain, graph, path, or lexical based on whether you need ranked documents, cited line ranges, or document relationships. - Vocabulary-Gap Recovery: Detects thin results via the confidence band and retries with corpus vocabulary, --expand passages, or fused multi-question queries. - Use Case: An agent asked "how do we roll back a release" finds fux not on PATH, resolves it via ./.venv/bin/fux, runs fux ask with --json, and reports ranked documents with freshness verdicts instead of guessing. ## Quick Start Resolve the fux command using the four-rung ladder, then run fux ask with your question and the --json flag to get ranked documentation results.

Frequently Asked Questions about fux-usage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run fux when the command is not found?▼

Probe four invocations in order: `fux --version`, `uv run fux --version`, `./.venv/bin/fux --version`, then `python -m fux --version`. Stop at the first that answers and cache it for the session. Never activate the virtualenv or install anything.

Which fux command should I use to search documentation?▼

Use `fux ask` with `--json` for ranked results you judge yourself, `fux find` for bare paths to pipe into other commands, and `fux answer` when you need a cited answer with exact line ranges and a freshness verdict.

Does fux ask return line numbers for matched documents?▼

No, `ask` and `find` return whole documents only. Only `fux answer` returns a line range like `docs/mesh.md:L10-L13`, because line ranges are computed by chunking the fetched source bytes, which the offline index does not store.

Why does my fux search return no confident matches?▼

The usual cause is a vocabulary gap: your question uses words absent from the corpus, shown by a `partial` confidence band with a non-empty `missing` list. Retry using the corpus's own terms, add an `--expand` passage you write yourself, or fuse two phrasings with repeatable `-q`.

Can I use fux on Windows or without a virtualenv activated?▼

Yes. On Windows the third rung is `.venv\Scripts\fux.exe --version`, and `uv run fux` resolves the command without any activation. The skill explicitly forbids activating environments or modifying PATH.