fux-correct

Writes human-authored question corrections onto indexed documents using the fux correct command.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the fux search index serves the wrong document for a question, this Skill records the question a person actually typed onto the document that truly answers it, durably fixing retrieval through committed, reviewable files. ## Core Features & Use Cases - Human corrections: Run fux correct "<question>" <doc> to append a real searcher's question to a document's enrichment file, indexed as the same ctx field. - Pinning and reaffirming: Use --pin to force one document to #1 for an exact question, --reaffirm to restore a suspended pin after the document changed, and --no-pin to drop a pin while keeping the correction. - Refusal handling: Interprets refusals such as negative corrections, PII rule matches from .fux/pii.toml, and suspended pins, and explains the right alternative (edit the document, supersede, or archive). - Use Case: A user asks "how do I roll back a release" and fux returns the wrong ADR; you propose fux correct "how do I roll back a release" docs/runbook-rollback.md so the runbook is indexed for that phrasing after fux ingest runs. ## Quick Start Ask the assistant to correct a wrong fux result by proposing the command, for example: fux served the wrong doc for "how do I roll back a release", pin it to docs/runbook-rollback.md.

Frequently Asked Questions about fux-correct

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

FAQPage Schema
How do I fix a wrong search result in fux?▼

Run fux correct "<question>" <doc> to write the question a person typed onto the document that answers it. The correction is committed to the document's enrichment file and takes effect only after fux ingest runs.

How do I pin a document to the top of fux search results?▼

Use fux correct "<question>" <doc> --pin to force one document to rank first for that exact question. Pins are applied after ranking, appear as "pinned": true in JSON output, and should only be added when explicitly requested.

Why was my fux correction refused?▼

Refusals happen when the question reads as a negative correction, matches a PII rule in .fux/pii.toml, references a document not in the index, or targets a suspended pin. A refused command writes nothing, so no files change.

What happens to a fux pin when the document changes?▼

A pin whose document changed is suspended and silently stops applying. The fux doctor command lists suspended pins under its correction pins row, and only a human should reaffirm them with --reaffirm after re-reading the document.

When should I edit the document instead of using fux correct?▼

Edit the document directly when it does not use the words people search with and you are allowed to change it. Corrections are meant for documents you do not own or must not modify, retired documents need supersedes or archived flags instead.