Skill: syedair/gog-html-email (version 1.0.0)

--- name: gog-html-email description: Send beautifully formatted HTML emails via gog CLI with templates and styling homepage: https://gogcli.sh metadata: { "openclaw": { "emoji": "📧", "requires": { "bins": ["gog"] } } } --- # gog-html-email Enhanced HTML email formatting for gog CLI with ready-to-use templates. ## How to Send HTML Emails **ALWAYS use this exact workflow:** 1. Read the appropriate template file from [REDACTED_SECRET] 2. Replace placeholders using `sed` commands 3. Send via `gog gmail send --body-html` **Example:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message here/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **For multi-paragraph messages:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) # Replace [MESSAGE] with multiple <p> tags for proper spacing MESSAGE='<p style="margin: 0 0 16px 0;">First paragraph.</p><p style="margin: 0 0 16px 0;">Second paragraph.</p><p style="margin: 0 0 16px 0;">Third paragraph.</p>' HTML=$(echo "$TEMPLATE" | sed "s|\[MESSAGE\]|$MESSAGE|g" | sed 's/\[NAME\]/John/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **DO NOT:** - Manually construct HTML strings - Use heredocs or multi-line strings - Include literal `\n` characters in HTML - Put multiple paragraphs in a single `<p>` tag ## Template Selection Guide Choose the right template based on the email purpose: **Business/Professional:** - `basic.html` - Simple professional emails - `meeting.html` - Meeting invitations (requires: NAME, TOPIC, DATE, TIME, DURATION, LOCATION, SIGNATURE) - `follow-up.html` - Follow-up emails - `status-update.html` - Project updates - `invoice.html` - Invoices and payments - `button.html` - Emails with call-to-action buttons - `newsletter.html` - Newsletters **Islamic/Religious:** - `jummah.html` - Friday greetings (Jummah Mubarak) - `eid.html` - Eid celebrations (Eid Mubarak) - `ramadan.html` - Ramadan greetings (Ramadan Mubarak) **Celebrations:** - `birthday.html` - Birthday wishes - `anniversary.html` - Anniversary wishes - `congratulations.html` - Congratulations messages - `new-year.html` - New Year wishes (requires: NAME, MESSAGE, YEAR, SIGNATURE) **Other:** - `welcome.html` - Welcome new users - `thank-you.html` - Thank you messages - `highlight.html` - Important announcements - `multi-paragraph.html` - Long-form content ## HTML Template Files All templates are available in the `templates/` directory. Each template uses placeholder variables in `[BRACKETS]` that you can replace with actual content. ### Available Templates 1. **basic.html** - Simple professional email - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` 2. **highlight.html** - Email with highlighted box - Placeholders: `[NAME]`, `[HIGHLIGHT_MESSAGE]`, `[MESSAGE]`, `[SIGNATURE]` 3. **button.html** - Email with call-to-action button - Placeholders: `[NAME]`, `[MESSAGE]`, `[BUTTON_URL]`, `[BUTTON_TEXT]`, `[SIGNATURE]` 4. **multi-paragraph.html** - Multiple paragraph email - Placeholders: `[NAME]`, `[PARAGRAPH_1]`, `[PARAGRAPH_2]`, `[PARAGRAPH_3]`, `[SIGNATURE]` 5. **meeting.html** - Meeting invitation - Placeholders: `[NAME]`, `[TOPIC]`, `[DATE]`, `[TIME]`, `[DURATION]`, `[LOCATION]`, `[SIGNATURE]` 6. **follow-up.html** - Follow-up email - Placeholders: `[NAME]`, `[TOPIC]`, `[MESSAGE]`, `[SIGNATURE]` 7. **newsletter.html** - Newsletter format - Placeholders: `[NEWSLETTER_TITLE]`, `[DATE]`, `[SECTION_1_TITLE]`, `[SECTION_1_CONTENT]`, `[SECTION_2_TITLE]`, `[SECTION_2_CONTENT]` 8. **invoice.html** - Invoice notification - Placeholders: `[NAME]`, `[INVOICE_NUMBER]`, `[DATE]`, `[AMOUNT]`, `[DUE_DATE]`, `[DESCRIPTION]`, `[PAYMENT_URL]`, `[SIGNATURE]` 9. **welcome.html** - Welcome email with CTA - Placeholders: `[NAME]`, `[MESSAGE]`, `[GET_STARTED_URL]`, `[SIGNATURE]` 10. **status-update.html** - Project status update - Placeholders: `[NAME]`, `[PROJECT_NAME]`, `[COMPLETED_ITEMS]`, `[IN_PROGRESS_ITEMS]`, `[BLOCKED_ITEMS]`, `[NEXT_STEPS]`, `[SIGNATURE]` ### Special Occasion Templates 11. **jummah.html** - Jummah Mubarak greeting - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Islamic greeting with blue gradient background 12. **eid.html** - Eid Mubarak greeting - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Green gradient background with Islamic blessings 13. **ramadan.html** - Ramadan Mubarak greeting - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Purple gradient background with Ramadan wishes 14. **birthday.html** - Birthday wishes - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Pink gradient background with celebration emojis 15. **anniversary.html** - Anniversary wishes - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Pink-yellow gradient with romantic theme 16. **congratulations.html** - Congratulations message - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Gold-blue gradient with success theme 17. **thank-you.html** - Thank you message - Placeholders: `[NAME]`, `[MESSAGE]`, `[SIGNATURE]` - Features: Soft pastel gradient with gratitude theme 18. **new-year.html** - New Year wishes - Placeholders: `[NAME]`, `[MESSAGE]`, `[YEAR]`, `[SIGNATURE]` - Features: Purple gradient with celebration theme ### Using Templates Directly ```bash # Read template, replace placeholders, and send TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message here/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` ### Quick Examples **Basic email:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Just wanted to check in on the project status./g' | sed 's/\[SIGNATURE\]/Sarah/g') gog gmail send --to [REDACTED_SECRET] --subject "Project Check-in" --body-html "$HTML" ``` **Meeting invitation:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/meeting.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/Team/g' | sed 's/\[TOPIC\]/Q1 Planning/g' | sed 's/\[DATE\]/March 15, 2026/g' | sed 's/\[TIME\]/2:00 PM/g' | sed 's/\[DURATION\]/1 hour/g' | sed 's/\[LOCATION\]/Conference Room A/g' | sed 's/\[SIGNATURE\]/Alex/g') gog gmail send --to [REDACTED_SECRET] --subject "Q1 Planning Meeting" --body-html "$HTML" ``` **Email with button:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/button.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/Sarah/g' | sed 's/\[MESSAGE\]/Please review the latest document./g' | sed 's|\[BUTTON_URL\]|https://docs.example.com/report|g' | sed 's/\[BUTTON_TEXT\]/View Document/g' | sed 's/\[SIGNATURE\]/Mike/g') gog gmail send --to [REDACTED_SECRET] --subject "Document Review" --body-html "$HTML" ``` **Jummah Mubarak:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/jummah.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/Ahmed/g' | sed 's/\[MESSAGE\]/Wishing you a blessed Friday filled with peace and blessings./g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Jummah Mubarak" --body-html "$HTML" ``` **Eid Mubarak:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/eid.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/Family/g' | sed 's/\[MESSAGE\]/May this Eid bring joy, happiness, and prosperity to you and your loved ones./g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Eid Mubarak" --body-html "$HTML" ``` **Birthday wishes:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/birthday.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/Sarah/g' | sed 's/\[MESSAGE\]/Hope your special day is filled with joy, laughter, and wonderful memories!/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Happy Birthday!" --body-html "$HTML" ``` ## Best Practices 1. **Use template files** - All templates are pre-formatted and tested 2. **Single-line HTML** - Templates are already single-line to avoid formatting issues 3. **Inline CSS** - All templates use inline styles for email client compatibility 4. **Max Width** - Templates are set to 600px for optimal viewing 5. **System Fonts** - Templates use `-apple-system, BlinkMacSystemFont, Segoe UI, Roboto` for best rendering 6. **Test First** - Send to yourself before sending to recipients 7. **Replace all placeholders** - Make sure to replace all `[PLACEHOLDER]` values with actual content ## Customizing Templates You can customize template colors, fonts, and styling by adding additional `sed` commands to replace CSS values. ### Common Customizations **Change gradient colors:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/birthday.html) # Replace pink gradient with blue gradient HTML=$(echo "$TEMPLATE" | sed 's/#f093fb/#4facfe/g' | sed 's/#f5576c/#00f2fe/g') # Then replace placeholders and send HTML=$(echo "$HTML" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **Change primary color:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) # Change all blue (#007bff) to purple (#667eea) HTML=$(echo "$TEMPLATE" | sed 's/#007bff/#667eea/g') HTML=$(echo "$HTML" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **Change background color:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/highlight.html) # Change highlight box from light gray to light blue HTML=$(echo "$TEMPLATE" | sed 's/#f8f9fa/#e3f2fd/g') HTML=$(echo "$HTML" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **Change font size:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) # Make heading larger (36px to 48px) HTML=$(echo "$TEMPLATE" | sed 's/font-size: 36px/font-size: 48px/g') HTML=$(echo "$HTML" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **Change layout alignment (left-align instead of center):** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/basic.html) # Remove centering: change "margin: 0 auto" to "margin: 0" HTML=$(echo "$TEMPLATE" | sed 's/margin: 0 auto/margin: 0/g') HTML=$(echo "$HTML" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` ### Color Palette Reference **Current template colors:** **Birthday (Pink):** - Gradient: `#f093fb` → `#f5576c` - Heading: `#f5576c` **Eid (Green):** - Gradient: `#11998e` → `#38ef7d` - Heading: `#11998e` **Jummah (Blue):** - Gradient: `#4facfe` → `#00f2fe` - Heading: `#4facfe` **Ramadan (Purple):** - Gradient: `#667eea` → `#764ba2` - Heading: `#667eea` **Anniversary (Pink-Yellow):** - Gradient: `#fa709a` → `#fee140` - Heading: `#fa709a` **Congratulations (Gold-Blue):** - Gradient: `#ffd89b` → `#19547b` - Heading: `#19547b` **Thank You (Pastel):** - Gradient: `#a8edea` → `#fed6e3` **New Year (Purple):** - Gradient: `#667eea` → `#764ba2` - Heading: `#667eea` **Suggested alternative palettes:** - Ocean: `#2E3192` → `#1BFFFF` - Sunset: `#FF512F` → `#F09819` - Forest: `#134E5E` → `#71B280` - Royal: `#8E2DE2` → `#4A00E0` - Warm: `#FF6B6B` → `#FFE66D` - Cool: `#4ECDC4` → `#556270` ### Advanced Customization **Multiple color changes:** ```bash TEMPLATE=$(cat workspace/skills/gog-html-email/templates/birthday.html) # Change to ocean theme HTML=$(echo "$TEMPLATE" | \ sed 's/#f093fb/#2E3192/g' | \ sed 's/#f5576c/#1BFFFF/g' | \ sed 's/\[NAME\]/John/g' | \ sed 's/\[MESSAGE\]/Your message/g' | \ sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` **Create custom template variant:** ```bash # Save customized version as new template TEMPLATE=$(cat workspace/skills/gog-html-email/templates/birthday.html) echo "$TEMPLATE" | sed 's/#f093fb/#2E3192/g' | sed 's/#f5576c/#1BFFFF/g' > workspace/skills/gog-html-email/templates/birthday-ocean.html # Now use the custom template TEMPLATE=$(cat workspace/skills/gog-html-email/templates/birthday-ocean.html) HTML=$(echo "$TEMPLATE" | sed 's/\[NAME\]/John/g' | sed 's/\[MESSAGE\]/Your message/g' | sed 's/\[SIGNATURE\]/Your Name/g') gog gmail send --to [REDACTED_SECRET] --subject "Subject" --body-html "$HTML" ``` ## Notes - Templates are single-line HTML to prevent formatting issues - For complex layouts (tables, multiple sections), create a custom template file - Always test HTML emails in multiple clients (Gmail, Outlook, Apple Mail) - Use plain text (`--body`) for simple messages without formatting needs


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: suspicious | SkillSpector: clean (LOW)