diff --git a/skills/agenteye-python-sdk/SKILL.md b/skills/agenteye-python-sdk/SKILL.md
index 91ce6e4..564efe1 100644
--- a/skills/agenteye-python-sdk/SKILL.md
+++ b/skills/agenteye-python-sdk/SKILL.md
@@ -142,6 +142,12 @@ Work with these; none of them raise, so none of them show up in testing.
   | `environment` | `$AGENTEYE_ENVIRONMENT`, else `"dev"` |
   | `flush_interval` | `0.5` (seconds) |
 
+  `base_dir` has one further opt-in: with `AGENTEYE_SPOOL_TO_FAILPROOFAI` set to
+  a truthy value **and** `~/.failproofai/custom-agents` already present, the SDK
+  spools there instead. Set it only on hosts where a daemon that watches that
+  directory is installed — the standard collector does not, and events written
+  somewhere nothing reads simply pile up with no error on either side.
+
   Each call *sets all three* — omitted arguments are **reset to default
   resolution**, not left alone. So a later `configure(flush_interval=1.0)`
   silently moves your events back to the default directory and re-resolves the