faq

Installation
SKILL.md

/faq — Answer a Question and Record It in the Repo FAQ

Turn a real question about the current repo into (1) an immediate answer in chat and (2) a permanent FAQ entry in the repo's docs. Works in any repo; no per-repo setup.

Inputs

  • question (from args or the message): the question to answer. Often pasted verbatim from a teammate (Slack/Teams/email). If absent, ask for it and stop.
  • --dry-run: answer in chat and show the proposed entry, but do not write the file. Report in conditional language ("would add", "would update"), never claim a write happened. When several dry-run questions run in one session, check later questions against earlier proposed entries too, not just the on-disk file.

Step 1 — Locate the FAQ document

Check in order, first hit wins:

  1. docs/faq.md
  2. docs/FAQ.md
  3. FAQ.md
  4. docs/faq/index.md

On case-insensitive filesystems (macOS, Windows) several candidates resolve to one file; write to the git-tracked casing (git ls-files docs/ | grep -i faq).

Installs
2
Repository
amit-t/skills
GitHub Stars
4
First Seen
Oct 21, 2026