diff --git a/claude-workflows/pr-review/scripts/pr-comment.sh b/claude-workflows/pr-review/scripts/pr-comment.sh
index a8145e32..b053f32b 100755
--- a/claude-workflows/pr-review/scripts/pr-comment.sh
+++ b/claude-workflows/pr-review/scripts/pr-comment.sh
@@ -87,7 +87,7 @@ while [ $# -gt 0 ]; do
       shift
       ;;
     *)
-      echo "Error: Unknown argument: $1"
+      echo "Error: Unknown argument: $1. Use: --severity <critical|high|medium|low|nitpick> --title <description> --why <reason> [--no-suggestion]"
       exit 1
       ;;
   esac
diff --git a/scripts/move-github-dotgithub.sh b/scripts/move-github-dotgithub.sh
index c9cbe5f4..0b2cff19 100755
--- a/scripts/move-github-dotgithub.sh
+++ b/scripts/move-github-dotgithub.sh
@@ -16,7 +16,7 @@ for arg in "$@"; do
       echo "  --push  git add, commit, and push after moving files"
       exit 0
       ;;
-    *) echo "Unknown flag: $arg"; exit 1 ;;
+    *) echo "Error: Unknown flag: $arg. Use --help for usage." >&2; exit 1 ;;
   esac
 done