diff --git a/.gitea/actions/discover-skins/action.yml b/.gitea/actions/discover-skins/action.yml
index 68301f3..154c7b6 100644
--- a/.gitea/actions/discover-skins/action.yml
+++ b/.gitea/actions/discover-skins/action.yml
@@ -7,7 +7,14 @@ inputs:
     required: false
     default: "false"
   target_skins:
-    description: "JSON array of skins to rebuild (e.g., '[\"skin1\", \"skin2\"]')"
+    description: >
+      JSON array of skins to rebuild.
+      NOTE: If any skin name contains a single quote ('),
+      you MUST escape it for Bash when passing JSON in single quotes.
+      Example:
+        Raw JSON: ["Beyond Journey's End"]
+        Bash-safe JSON: ["Beyond Journey'\''s End"]
+      Example usage: '[\"skin1\", \"skin2\"]'
     required: false
     default: ""