diff --git a/src/serena/resources/config/modes/mode.template.yml b/src/serena/resources/config/modes/mode.template.yml
index 6d836ca3..d7efce0d 100644
--- a/src/serena/resources/config/modes/mode.template.yml
+++ b/src/serena/resources/config/modes/mode.template.yml
@@ -1,7 +1,8 @@
 # See Serena's documentation for more details on concept of modes.
-description: Description of the mode, not used in the code.
-prompt: Prompt that will form part of the message sent to the model when activating this mode.
+description: Description of the mode (meta-information only)
+prompt: |
+  Provide a prompt that will form part of the instructions sent to the model when this mode is activated.
+# tools that are to be excluded by this mode
 excluded_tools: []
-
 # several tools are excluded by default and have to be explicitly included by the user
 included_optional_tools: []
\ No newline at end of file