comms

/comms - Slack & Trello Communications Skill

Post messages to Slack channels and create/update Trello cards with natural language commands.

Usage

/comms [message or instruction]

Key Rules

Trello Comments

Always prefix Trello comments with "From Claude Code: "

Example: If asked to add comment "Fixed the bug", post:

From Claude Code: Fixed the bug

Fuzzy Matching

Match user input to channels/boards using aliases. Examples:

• "android" -> tech-android (Slack) or Android list (Trello)
• "ios" -> tech-ios (Slack) or IOS App list (Trello)
• "server" -> tech-server (Slack) or Server list (Trello)

Smart Defaults

• Tech topics without channel specified -> tech-general
• Tech topics without board specified -> Tech Work board
• Business/org topics -> Org-Business Work board

Example Commands

Resources

See RESOURCES.md for complete channel/board mappings with IDs.

MCP Tools Used

Slack

• mcp__slack__slack_post_message - Post to channel
• mcp__slack__slack_reply_to_thread - Reply in thread
• mcp__slack__slack_get_channel_history - Read messages
• mcp__slack__slack_add_reaction - Add emoji reaction

Trello

• mcp__trello__add_card_to_list - Create card
• mcp__trello__add_comment - Add comment (remember prefix!)
• mcp__trello__update_card_details - Update card
• mcp__trello__move_card - Move card between lists
• mcp__trello__get_cards_by_list_id - List cards

Workflow

1. Parse user intent (Slack, Trello, or both)
2. Resolve channel/board/list using fuzzy matching
3. Convert content to platform-native formatting (see below)
4. Execute appropriate MCP tool(s)
5. Confirm action to user

Platform Formatting Guidelines

CRITICAL: Neither Trello nor Slack supports markdown tables. You must convert tabular data to platform-native formats.

Trello Formatting (Markdown subset)

Supported:

• Bold: **text** or __text__
• Italic: *text* or _text_
• Strikethrough: ~~text~~
• Headings: # H1, ## H2, ### H3
• Bulleted lists: - item or * item (blank line required above list)
• Numbered lists: 1. item
• Code blocks: ``` or indent 4 spaces
• Links: [text](url)
• Horizontal rule: ---

NOT Supported:

• Tables (pipes and dashes render as plain text)
• Nested formatting in some contexts

Slack Formatting (mrkdwn, NOT markdown)

Supported:

• Bold: *text* (single asterisk, unlike markdown)
• Italic: _text_
• Strikethrough: ~text~ (single tilde)
• Code: `code`
• Code blocks: ``` (no syntax highlighting)
• Links: <url|text> (angle brackets, not square)
• Blockquotes: > at line start
• Lists: Use bullet character or numbers

NOT Supported:

• Tables
• Headings (# doesn't work)
• Standard markdown link syntax

Converting Tables to Native Formats

Option 1: Key-Value Lists (Recommended for Trello)

Instead of:

| Component | Cost |
|-----------|------|
| GPU | $100 |
| STT | $0 |

Use:

**Components:**
- **GPU:** $100
- **STT:** $0

Option 2: Grouped Sections (Best for comparisons)

Instead of a comparison table, use:

## 20 Users
- **Total:** $100/month
- GPU: $87-100
- STT: $0 (Groq free tier)
- TTS: $0 (self-hosted)

## 100 Users
- **Total:** $175/month
- GPU: $115-145
- STT: $0-30
- TTS: $0 (self-hosted)

Option 3: Code Block (Preserves alignment)

For data that must stay aligned, use a code block:

Component          20 Users    100 Users
─────────────────────────────────────────
GPU                $100        $150
STT                $0          $0-30
TTS                $0          $0
─────────────────────────────────────────
TOTAL              $100        $175

Option 4: Inline Summary (For Slack)

Slack messages should be concise:

*Cost Summary:*
• 20 users: *$100/mo* (GPU $100, STT free, TTS free)
• 100 users: *$175/mo* (GPU $150, STT $0-30, TTS free)

Formatting Checklist

Before posting to Trello or Slack:

• Convert all markdown tables to lists or code blocks
• Ensure blank line before any list
• Use platform-specific bold/italic syntax
• Use <url|text> for Slack links, [text](url) for Trello
• Keep Slack messages concise; Trello can be longer