From ec763a754610c1414d25ad296039625f475ec61f Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 11 Jan 2026 23:33:31 +0000
Subject: [PATCH] docs: add skill override faq

---
 docs/start/faq.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/start/faq.md b/docs/start/faq.md
index d6acf45b2..b1e9799cb 100644
--- a/docs/start/faq.md
+++ b/docs/start/faq.md
@@ -137,6 +137,10 @@ clawdbot daemon restart
 
 Doctor detects a gateway service entrypoint mismatch and offers to rewrite the service config to match the current install (use `--repair` in automation).
 
+### How do I customize skills without keeping the repo dirty?
+
+Use managed overrides instead of editing the repo copy. Put your changes in `~/.clawdbot/skills/<name>/SKILL.md` (or add a folder via `skills.load.extraDirs` in `~/.clawdbot/clawdbot.json`). Precedence is `<workspace>/skills` > `~/.clawdbot/skills` > bundled, so managed overrides win without touching git. Only upstream-worthy edits should live in the repo and go out as PRs.
+
 ### Is there a dedicated sandboxing doc?
 
 Yes. See [Sandboxing](/gateway/sandboxing). For Docker-specific setup (full gateway in Docker or sandbox images), see [Docker](/install/docker).