OpenSkillIndex← back to search
claude-code

Skills tsticker

Manage Telegram sticker packs via tsticker CLI. Init, push, sync, download, and trace sticker packs. Use when user wants to create/update Telegram sticker packs, push stickers to Telegram, sync packs, or manage sticker collections. Integrates with create-sticker for end-to-end sticker generation → publish workflow.

install
source · Clone the upstream repo
git clone https://github.com/stvlynn/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/stvlynn/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tsticker" ~/.claude/skills/stvlynn-skills-tsticker && rm -rf "$T"
manifest: skills/tsticker/SKILL.md
source content

tsticker — Telegram Sticker Pack Manager

Prerequisites

  • tsticker
    installed via 
    pipx install tsticker --python python3.13 --pip-args="--ignore-requires-python"
  • ffmpeg
    and 
    ImageMagick
    installed (for animated sticker conversion)
  • Telegram Bot Token (from @BotFather) + owner user ID

Auth

tsticker login -t <BOT_TOKEN> -u <USER_ID>

Credentials stored via system keyring.

Commands

CommandDescription
tsticker init -s regular -n 'pack_name' -t 'Pack Title'
Create new sticker pack
tsticker push
Push local stickers → overwrite cloud pack
tsticker sync
Pull cloud pack → overwrite local files
tsticker download -l <sticker_link>
Download any pack (read-only)
tsticker trace -l <sticker_link>
Import pack (editable, must be your bot's pack)
tsticker show
Show local pack info

Sticker Pack Directory Structure

<pack_dir>/
├── index.json          # Pack metadata (only `title` is editable)
└── stickers/           # Put images here
    ├── 😄hello.png     # Emoji in filename = explicit emoji
    ├── coffee.png       # No emoji = auto-detected
    └── animation.gif    # Auto-converted to webm

Workflow: Generate → Publish

1. Create pack (first time only)

cd ~/Pictures/lynn-stickers
tsticker init -s regular -n 'lynn_stickers_by_<bot_name>' -t 'Lynn Stickers'

2. Generate stickers (create-sticker skill)

python3 /path/to/skills/skills/create-sticker/scripts/create_sticker.py "drinking bubble tea happily"

3. Copy approved stickers into pack

cp ~/stickers/drinking_bubble_tea.png ~/Pictures/lynn-stickers/stickers/🧋drinking_tea.png

Emoji prefix in filename sets the sticker's emoji. Without prefix, tsticker auto-selects.

4. Push to Telegram

cd ~/Pictures/lynn-stickers
tsticker push

⚠️ 

push
overwrites the entire cloud pack with local files. Always 
sync
first if cloud has changes you want to keep.

Notes

  • Rate limited: ~2s per sticker operation
  • Don't push too many stickers at once — errors break the flow, recover with 
    tsticker sync
  • Sticker types: 
    regular
    (static/animated), 
    mask
    , 
    custom_emoji
  • Supported formats: png, jpg, gif, webm, mov (auto-converted)
  • Bot can only manage packs it created — losing the bot means manual management only