diff --git a/cylc/flow/cfgspec/workflow.py b/cylc/flow/cfgspec/workflow.py
index e02a5d5639..0e7d66ed02 100644
--- a/cylc/flow/cfgspec/workflow.py
+++ b/cylc/flow/cfgspec/workflow.py
@@ -1359,7 +1359,7 @@ def get_script_common_text(this: str, example: Optional[str] = None):
 
                     .. seealso::
 
-                       - :ref:`task-run-modes`
+                       - :ref:`task-run-modes.skip`
                        - :cylc:conf:`flow.cylc[runtime][<namespace>][skip]`
 
                     .. versionadded:: 8.4.0
@@ -1481,7 +1481,7 @@ def get_script_common_text(this: str, example: Optional[str] = None):
                 modes.
 
                 For a full description of simulation and dummy run modes see
-                :ref:`SimulationMode`.
+                :ref:`task-run-modes.simulation`.
             '''):
                 Conf('default run length', VDR.V_INTERVAL, DurationFloat(10),
                      desc='''