feishu-card

name	feishu-card
description	Send rich interactive cards to Feishu (Lark) users or groups. Supports Markdown (code blocks, tables), titles, color headers, and buttons.
tags	["feishu","lark","card","message","interactive","markdown"]

Feishu Card Skill

Send rich interactive cards via Feishu Open API.

⚠️ CRITICAL FORMATTING RULES (READ BEFORE USING)

1. Escape Newlines: If using --text via CLI, you MUST escape newlines as \\n.
   • ❌ Wrong: --text "Line 1\nLine 2" (Shell eats the backslash)
   • ✅ Right: --text "Line 1\\nLine 2"
2. Prefer File Input: For any content longer than one line, ALWAYS use --text-file.
   • ✅ Best: echo "Line 1\nLine 2" > msg.md && node send.js ... --text-file msg.md
   • This avoids ALL shell escaping issues.
3. Markdown Support: Supports Bold, Italic, Links.
   • ⚠️ Code Blocks: Support is limited. Use single backticks `code` for safety.

Usage

# Via argument (Simple)
node skills/feishu-card/send.js --target "ou_..." --text "Hello **World**"

# Via file (Recommended for Reports/Long Text)
cat <<EOF > msg.md
**Status**: Ready
**Details**:
- Item 1
- Item 2
EOF
node skills/feishu-card/send.js --target "ou_..." --title "Report" --text-file msg.md
rm msg.md

Options

• -t, --target: User Open ID (ou_...) or Group Chat ID (oc_...).
• -x, --text: Markdown content.
• -f, --text-file: Read markdown from file.
• --title: Card header title.
• --color: Header color (blue, red, green, etc.).
• --button-text: Add a bottom button.
• --button-url: Button URL.