diff --git a/skills/gitea/SKILL.md b/skills/gitea/SKILL.md
index 66c71b0..6d64166 100644
--- a/skills/gitea/SKILL.md
+++ b/skills/gitea/SKILL.md
@@ -119,15 +119,15 @@ tea clone <owner>/<repo>             # Clone repository
 tea comment <number> "<comment body>"
 tea comment 3 "LGTM, ready to merge"
 
-# Multiline comments (use heredoc)
-tea comment 3 "$(cat <<'EOF'
-## Review Summary
+# Multiline comments (use quoted strings with literal newlines)
+tea comment 3 "## Review Summary
+
 - Code looks good
-- Tests pass
-EOF
-)"
+- Tests pass"
 ```
 
+> **Warning**: Do not use heredoc syntax `$(cat <<'EOF'...EOF)` with `tea comment` - it causes the command to be backgrounded and fail silently.
+
 ### Notifications
 
 ```bash