From 644a41cf42b0400528b8bdb521bb439b3b30a45c Mon Sep 17 00:00:00 2001
From: Tim Pillinger <26465611+wxtim@users.noreply.github.com>
Date: Mon, 2 Dec 2024 16:20:35 +0000
Subject: [PATCH] Update cylc/flow/cfgspec/workflow.py

Co-authored-by: Ronnie Dutta <61982285+MetRonnie@users.noreply.github.com>
---
 cylc/flow/cfgspec/workflow.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/cylc/flow/cfgspec/workflow.py b/cylc/flow/cfgspec/workflow.py
index fbd0d9837f..e02a5d5639 100644
--- a/cylc/flow/cfgspec/workflow.py
+++ b/cylc/flow/cfgspec/workflow.py
@@ -1350,6 +1350,12 @@ def get_script_common_text(this: str, example: Optional[str] = None):
                     ``{RunMode.SKIP.value}``:
                         {RunMode.SKIP.describe()}
 
+                        .. note::
+
+                           This is primarily intended to be set at runtime via
+                           a broadcast; Cylc will warn you about any tasks
+                           set to run in skip mode in the workflow
+                           configuration at validation time.
 
                     .. seealso::