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:
docs/faq.mddocs/FAQ.mdFAQ.mddocs/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).