diff --git a/bin/omarchy-hw-touchscreen b/bin/omarchy-hw-touchscreen
index 47157398..337fd0df 100755
--- a/bin/omarchy-hw-touchscreen
+++ b/bin/omarchy-hw-touchscreen
@@ -1,4 +1,6 @@
 #!/bin/bash
 
+# omarchy:summary=Print the detected Hyprland touchscreen or tablet device name
+
 device=$(hyprctl devices -j | jq -r '[.touch[]?.name, .tablets[]?.name] | first // empty')
 [[ -n $device ]] && echo "$device"
diff --git a/bin/omarchy-hyprland-monitor-internal-mirror b/bin/omarchy-hyprland-monitor-internal-mirror
index f4457b2a..07a0ccad 100755
--- a/bin/omarchy-hyprland-monitor-internal-mirror
+++ b/bin/omarchy-hyprland-monitor-internal-mirror
@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# omarchy:summary=Enable, disable, toggle, or recover mirroring the internal display to an external monitor
+# omarchy:args=<on|off|toggle|recover>
+
 TOGGLE="internal-monitor-mirror"
 TOGGLE_FLAG="$HOME/.local/state/omarchy/toggles/hypr/$TOGGLE.conf"
 DISABLE_TOGGLE="internal-monitor-disable"
diff --git a/bin/omarchy-theme-colors-from-alacritty b/bin/omarchy-theme-colors-from-alacritty
index 8f69aeee..7c41b5ec 100755
--- a/bin/omarchy-theme-colors-from-alacritty
+++ b/bin/omarchy-theme-colors-from-alacritty
@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# omarchy:summary=Generate a theme's colors.toml from its alacritty.toml palette
+# omarchy:args=<theme-dir>
+
 set -e
 
 THEME_SOURCE="${1:-}"