OpenParable
Skip to content
← Back to skills

Slack Formatting

Productivity
slack-formatting

Slack Formatting is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Format messages correctly for Slack using mrkdwn syntax. Use this skill when sending messages to Slack channels or DMs via the AI agent. Covers the differences between standard Markdown and Slack mrkdwn, including bold (*single asterisks*), italic (_underscores_), code formatting, links, and emoji shortcodes. Use when asked to "send a Slack message", "format for Slack", or when composing any Slack communication.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/communication/slack-formatting-orient-bot-orient-3bf74f11/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/slack-formatting, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Slack Message Formatting

Slack uses mrkdwn format, NOT standard Markdown.

Text Formatting

StyleSlack mrkdwnStandard Markdown (WRONG)
Bold*text***text**
Italic_text_*text*
Code`text``text` ✓
Strike~text~~text~ ✓

Headers

Slack does NOT support markdown headers.

  • ❌ Wrong: ## Header
  • ✅ Correct: Use *Bold Text* with line breaks

Links

Format: <url|link text>
Example: <https://jira.example.com|View in Jira>
Auto-link: <https://example.com>

Lists

  • Bullet points: • item or - item
  • Numbered lists: 1. item

Code Blocks

Use triple backticks (same as standard markdown)

Block Quotes

> This is a quote

Common Emoji Shortcodes

ShortcodeEmoji
:white_check_mark:✅
:warning:⚠️
:rocket:🚀
:fire:🔥
:thinking_face:🤔
:tada:🎉
:x:❌

Example Comparison

❌ Wrong (Standard Markdown)

## **Breakdown by Status:**

### 🔨 **In Progress (2 issues)**

- **PROJ-25519** - Create analytics events (Tom)
- **PROJ-26838** - Export Case Details (Unassigned)

✅ Correct (Slack mrkdwn)

*Breakdown by Status:*

*🔨 In Progress (2 issues):*
• `PROJ-25519` - Create analytics events (Tom)
• `PROJ-26838` - Export Case Details (Unassigned)

*✅ Ready for Deployment (2 issues):*
• `PROJ-25731` - HPO term fix (Daniel)
• `PROJ-25607` - Fix text highlighting (Amitai)

MCP Tools

  • ai_first_slack_send_dm - Send direct message
  • ai_first_slack_send_channel_message - Send to channel
  • ai_first_slack_lookup_user_by_email - Look up user

Verification Checklist

  • Bold text uses *single asterisks*
  • No ## header symbols visible
  • Issue keys appear in monospace with backticks
  • Emoji render properly
  • Links use <url|text> format