diff --git a/skyvern/forge/prompts/skyvern/CLAUDE.md b/skyvern/forge/prompts/skyvern/CLAUDE.md
new file mode 100644
index 00000000..6c4a68c5
--- /dev/null
+++ b/skyvern/forge/prompts/skyvern/CLAUDE.md
@@ -0,0 +1,9 @@
+# Prompt Templates
+
+Action extraction templates are split for caching optimization:
+
+- `extract-action.j2` — Complete template (static + dynamic)
+- `extract-action-static.j2` — Cacheable prefix
+- `extract-action-dynamic.j2` — Dynamic suffix with runtime variables
+
+When modifying `extract-action.j2`, update the static/dynamic files to match. The static file must exactly match the prefix of the complete file.