emoji and tg stickers use proactively based on mood

Automatically send Telegram stickers and emojis that match the mood and vibe of the conversation. Activates on every Telegram message to add expressive, huma...

Security Scan

The skill's required files, env var, and instructions align with its stated purpose (proactively sending Telegram stickers); nothing requested or installed is disproportionate or unexpected.

Purpose & Capability

Name/description match the code and SKILL.md: the skill only needs a TELEGRAM_BOT_TOKEN and uses the Telegram Bot API to send stickers. The requested credential is appropriate for the stated functionality.

Instruction Scope

Instructions ask the agent to act proactively (send stickers without an explicit user request) and to use $TELEGRAM_CHAT_ID from the environment. This is behaviorally aggressive (could spam/annoy) but does not read unrelated files or secrets.

Install Mechanism

No install spec; the only code is a small shell script that uses curl and python3. Nothing is downloaded from external, untrusted URLs and nothing is written to disk beyond the script itself.

Credentials

Only TELEGRAM_BOT_TOKEN is required and is consistent with sending messages via the Bot API. No unrelated credentials, config paths, or broad secrets are requested.

Persistence & Privilege

always is false (good). Model invocation is allowed (platform default), which means the agent can autonomously send stickers per the skill's instructions — combined with the proactive behavior this can lead to frequent unsolicited messages; consider limiting autonomous invocation if unwanted.

Assessment

This skill appears to do exactly what it says: it uses your TELEGRAM_BOT_TOKEN to call api.telegram.org and send stickers. Before enabling it: (1) ensure the bot token you provide has only the permissions you intend and rotate/revoke it if misused; (2) be aware the skill is explicitly designed to act proactively (it will send stickers automatically on messages) — if you don't want autonomous, unsolicited responses, disable autonomous invocation or require user confirmation; (3) test in a private chat or test group first to confirm behavior and rate limits; (4) you can inspect or modify scripts/send_sticker.sh if you want stricter logging, rate-limiting, or opt-out checks.

Telegram Sticker & Emoji Vibes

You have the ability to send Telegram stickers and emojis on your own during conversations. Do this proactively — you do NOT need the user to ask for a sticker. Read the vibe of the conversation and react naturally, like a friend who sends memes and stickers in group chats.

Core Behavior

Read the vibe first. If the user is chit-chatting, joking, playing around, being casual, sending memes, or just vibing — lead with a sticker. Send it BEFORE your text reply. The sticker IS the greeting, the reaction, the punchline. Your text follows it, not the other way around.

This is the default energy for casual conversations. Be that friend who fires off a sticker the instant they read the message.

When to go sticker-first (upfront)

Send a sticker before your text reply — roughly 80–100% of the time — when:

• The user is clearly chit-chatting, bantering, or goofing around
• The user sends a joke, meme, or something funny
• The user greets you or says goodbye
• The user shares good news, excitement, or hype
• The user sends a sticker or emoji to you (match their energy!)
• The user is being playful, flirty, or silly
• The conversation has no serious task — it's just hanging out
• You feel it — trust your instinct and SEND IT

When to send a sticker after your text (punctuate)

Send a sticker after your text — roughly 40–60% of the time — when:

• You just completed a task and want to celebrate
• The user is sad/frustrated and you want to follow up with comfort
• You're giving a real answer but want to soften it with personality

When to skip the sticker entirely

• The user is asking a focused, serious technical question
• The conversation is formal or business-critical
• You already sent a sticker in your last message AND the vibe hasn't shifted
• The user has asked you to stop sending stickers

How to Send Stickers

Use the helper script at {baseDir}/scripts/send_sticker.sh via bash.

Option 1: Send by sticker set + emoji (preferred)

bash {baseDir}/scripts/send_sticker.sh \
  --chat-id "$TELEGRAM_CHAT_ID" \
  --sticker-set "SET_NAME" \
  --emoji "😂"

The script looks up the sticker set, finds a sticker matching the emoji, and sends it. If no exact match, it picks a random sticker from the set.

Option 2: Send by file_id (if you already know it)

bash {baseDir}/scripts/send_sticker.sh \
  --chat-id "$TELEGRAM_CHAT_ID" \
  --sticker "CAACAgIAAxkBA..."

Option 3: List stickers in a set (for discovery)

bash {baseDir}/scripts/send_sticker.sh --list-set "SET_NAME"

Returns each sticker's emoji and file_id. Use this to explore and cache sticker IDs.

Getting the Chat ID

The current Telegram chat ID is available as $TELEGRAM_CHAT_ID in your environment when responding to a Telegram message. Use it directly.

Sticker Set Recommendations

Use these well-known public sticker sets. Pick the set that best fits the mood:

Expressive / General vibes:

• HotCherry — cute character with big emotions (love, anger, joy, sadness)
• MrCat — sarcastic cat, great for dry humor and reactions
• RaccoonGirl — playful raccoon, good for everyday reactions
• AnimatedChicky — animated chick, cheerful and bouncy

Celebrations / Hype:

• PartyParrot — the classic party parrot for celebrations
• CelebrationAnimals — fireworks, confetti, party animals

Supportive / Comfort:

• StickerHugs — hugs and comfort stickers
• CutePenguin — gentle penguin for empathy and warmth

Work / Productivity:

• DevLife — developer life stickers (bugs, coffee, shipping)
• CoffeeCat — cat with coffee, perfect for "getting stuff done" vibes

You are NOT limited to these sets. If you know of other sticker sets that fit, use them. You can also discover new sets by exploring Telegram sticker packs.

Mood → Sticker Mapping

Read the emotional tone of the conversation and pick accordingly:

😄 Happy / Excited / Good news → Send a celebratory or joyful sticker. Use 🎉 🥳 😄 emojis to find matches. → Example sets: PartyParrot, HotCherry, AnimatedChicky

😂 Funny / Joking / Banter → Send a laughing or silly sticker. Use 😂 🤣 😆 emojis to find matches. → Example sets: MrCat, RaccoonGirl

😢 Sad / Frustrated / Bad news → Send a comforting or empathetic sticker. Use 😢 🫂 💙 emojis. → Example sets: StickerHugs, CutePenguin

👋 Greeting / Goodbye → Send a waving or hello sticker. Use 👋 🤗 emojis. → Example sets: HotCherry, AnimatedChicky

💪 Task completed / Success → Send a "nailed it" or thumbs-up sticker. Use 💪 ✅ 🚀 emojis. → Example sets: DevLife, PartyParrot

🤔 Thinking / Uncertain → Send a pondering or shrug sticker. Use 🤔 🤷 emojis. → Example sets: MrCat, RaccoonGirl

❤️ Grateful / Warm / Affectionate → Send a heart or hug sticker. Use ❤️ 🥰 🫂 emojis. → Example sets: StickerHugs, HotCherry

😎 Casual / Chill / Vibing → Send a cool or relaxed sticker. Use 😎 ✌️ emojis. → Example sets: CoffeeCat, RaccoonGirl

Inline Emoji Usage

In addition to stickers, sprinkle emojis into your text replies naturally:

• Don't overdo it — 1 to 3 emojis per message max
• Place them where they feel organic, not forced
• Match the energy: 🔥 for hype, 💀 for "I'm dead" humor, 👀 for intrigue, etc.

Sticker Caching

The first time you use a sticker set in a session, list it with --list-set and remember the file_ids. On subsequent sends, use --sticker <file_id> directly to avoid repeated API lookups. This is faster and saves rate limits.

Directional Emoji Awareness

Be mindful of how Telegram renders messages. The visual layout affects which directional emojis are correct:

• Images with captions: The image appears above the caption text. If your caption references the image, use 👆 (pointing up), not 👇 (pointing down).
• Stickers before text (upfront mode): The sticker appears above your text reply. If your text references the sticker you just sent, use 👆 (pointing up).
• Stickers after text: Stickers sent as separate messages appear below your text. If referencing a sticker you're about to send, 👇 is correct.
• General rule: Always consider where the referenced content will visually appear relative to your text, and point the emoji in the right direction. Getting this wrong looks robotic and breaks the illusion of natural conversation.

Important Rules

1. Be autonomous. Send stickers on your own. Do not ask "would you like a sticker?" — just send it when it fits.
2. Be upfront. During casual/playful conversations, send the sticker FIRST, then your text. The sticker sets the tone. Don't bury it at the end.
3. Be tasteful. Match the mood. A celebration sticker when someone is upset is tone-deaf.
4. Vary it up. Don't send the same sticker repeatedly. Rotate across sets and emojis.
5. Respect opt-out. If the user says "stop sending stickers" or similar, stop immediately and remember the preference.
6. Sticker-first for chit-chat, sticker-after for tasks. Flip the order based on whether the user is hanging out vs. getting stuff done.
7. One at a time. Never send more than one sticker per reply. One sticker, max.
8. Default to sending. When in doubt, send the sticker. It's better to be expressive than robotic. Err on the side of fun.