Agent skill
slack-message-formatter
This skill should be used when the user asks to parse, format, organize, or work with a message. It asks if the message is for Slack and formats using Slack's minimal markdown with natural conversational flow.
Install this agent skill to your Project
npx add-skill https://github.com/yurifrl/cly/tree/main/.claude/skills/slack-message-formatter
SKILL.md
Slack Message Formatter
When the user asks you to parse, format, organize, or do anything with a message, always ask if this is for Slack before proceeding.
If yes, format the message following these rules:
Slack Formatting Rules
Text Formatting
- Bold: Single asterisk
*bold*(NOT double**) - Italic: Underscore
_italic_ - Strikethrough: Tilde
~strike~ - Code: Backticks
`code` - Code block: Triple backticks
- Quote: Prefix line with
>
Structure
- Minimal line breaks: Don't break lines excessively. Keep paragraphs flowing naturally like human conversation
- No markdown separators: Never use
---or=== - Natural flow: Write like you're typing in a chat, not composing formal documentation
Lists
- No special list syntax - use plain text with line breaks
- Use
-or•for bullets if needed - Sublists: Indent with 4 spaces (one tab)
Mentions & Links
- User mentions:
@username(Slack converts to<@USER_ID>) - Links:
<URL|display text>or just raw URL - Email:
<mailto:email@domain.com|Name>
Line Breaks
- Use actual line breaks (not
\nstrings) - Keep related content together
- Separate distinct topics with single blank line
Formatting Style
Key principle: Write like a human in a chat app, not like you're writing documentation.
Good example (what Slack messages look like):
Hey Greg,
Happy New Year! Apologies if I missed your email—not the most tech-savvy with email management.
I'd like to discuss a few topics:
*Custom DNS* - We talked about this as a WIP feature. I'd like to know more about the current status.
*Cloudflare Access replacement* - Looking for an alternative to give external users access to specific internal services. We're using it now but feel we're underutilizing it. A showcase would be helpful.
*People to loop in:*
@supergrilo - Behind our IAM team
@Diego Fagundes - Head of SRE, would appreciate the context
Bad example (too formal, over-structured):
---
Hey Greg,
Happy New Year!
Apologies if I overlooked your message—not the most tech-savvy with notifications.
I'd like to discuss a few topics:
**Custom DNS**
- We talked about this as a WIP feature
- I'd like to know more about the current status
**Cloudflare Access replacement**
- Looking for an alternative
- Give external users access to specific internal services
---
People to loop in:
- @supergrilo - Behind our IAM team
- @Diego Fagundes - Head of SRE
---
Workflow
- When user asks to work with a message, ask: "Is this for Slack?"
- If yes, format using the rules above
- Use
pbcopyto pipe the result to clipboard - Keep it conversational and natural
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ag:changelog
Generates and updates project CHANGELOG.md from git commits, conversation decisions, and architectural changes. Auto-invoke this skill when new features are added, features are removed, or architecture changes occur.
prompt-engineering
Prompt engineering reference and workflow for creating, refining, and reviewing high-quality prompts for AI tools, agents, and skills.
ag:claudemd-update
Updates CLAUDE.md based on recent conversation history. This skill should be used when the user asks to update their CLAUDE.md, sync learnings from conversations, or review what was discussed recently.
write-skill
Create Claude Code skills with proper structure and documentation. Use when building custom skills, writing SKILL.md files, or when user asks "write a skill" or "create Claude skill".
add-module
Create new demo or utility modules following CLY project patterns. Use when adding TUI demonstration modules to modules/demo/ or utility modules to modules/, following Bubbletea/Bubbles conventions with proper Cobra CLI integration.
git-worktrees
Manage git worktrees for parallel development. Use when user mentions worktrees, parallel branches, or working on multiple branches simultaneously.
Didn't find tool you were looking for?