diff --git a/docs/src/modules.md b/docs/src/modules.md
index 153e62ee..4c8de664 100644
--- a/docs/src/modules.md
+++ b/docs/src/modules.md
@@ -208,3 +208,11 @@ This will be inserted before the automatically generated list of options.
 
 Adding [testbeds](./testbeds.md) for new modules is encouraged, but not
 mandatory.
+
+## Common Mistakes
+
+### `home.activation` Scripts
+
+Any script run by `home.activation` must be preceded by `run` if the script is
+to produce any permanent changes. Without this `run` wrapper, the script is run
+in dry-run mode.
diff --git a/modules/kde/hm.nix b/modules/kde/hm.nix
index 5dc01f67..90c47d36 100644
--- a/modules/kde/hm.nix
+++ b/modules/kde/hm.nix
@@ -370,7 +370,7 @@ in
 
           # This activation entry will run the theme activator when the homeConfiguration is activated
           activation.stylixLookAndFeel = lib.hm.dag.entryAfter [ "writeBoundary" ] ''
-            ${activator} || verboseEcho \
+            run ${activator} || verboseEcho \
               "Stylix KDE theme setting failed. This only works in a running Plasma session."
           '';
         };