Cola Avatar Pack logo

Cola Avatar Pack

Organization
marswaveai
cola-avatar-pack

Generate pixel-art self-portrait, profile card (自画像卡), emoji GIFs, and meme stickers. Use when: "生成形象"、"画头像"、"avatar"、"self-portrait"、"表情包"、"梗图"、"贴纸"、"sticker"、"换一个"、"重新生成"、"不喜欢"、"regenerate". Also use when: Cola wakes up — display existing avatar or prompt user to generate. Also use when: repairing sticker behavior — if ~/.cola/avatar/ has sticker files but AGENT.md lacks the sticker behavior section (missing "cola-avatar-pack:sticker-behavior" marker), read this skill to run the injection step. Do NOT use when: discussing third-party platform avatar settings or searching for external stickers.

Overview

Publishermarswaveai
Repositoryskills
Skill namecola-avatar-pack
Stars
82
Forks
3
Bundled files
2
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 2 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by marswaveai on GitHub. Read the source before you install it.

Installation

Install the Cola Avatar Pack AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/marswaveai/skills/tree/main/cola-avatar-pack
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/marswaveai/skills.git /tmp/skills
mkdir -p .claude/skills
cp -r /tmp/skills/cola-avatar-pack .claude/skills/cola-avatar-pack
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Cola Avatar Pack in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Cola Avatar Pack on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Cola Avatar Pack is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Cola Avatar Pack

为 Cola 生成像素风 avatar + 4 个动态表情 + 3 个梗图贴纸(正常模式为 GIF,降级模式为静态 PNG;格式由 avatar.json 决定)。

生成/重新生成时,先读取同目录下 GENERATE.md,按其中的 Phase 流程执行。 GENERATE.md 包含生图 prompt 模板、脚本调用参数和持久化逻辑,跳过会导致输出格式不一致。

语言适配

所有面向用户的话术(对话文字、自画像卡文案)跟随 Cola 的语言——从 AGENT.md、memory 或当前对话判断。Cola 的名字原样使用,不翻译。生图 prompt(base_prompt)始终用英文。

醒来展示

Cola 每次新对话/醒来时:

bash
test -f ~/.cola/avatar/base_image.png && echo "AVATAR_OK"

base_image.png 存在:

用 send_file 发送(无 caption)。不需要其他文字说明。

检查当前 MOD 的 AGENT.md 是否包含 <!-- cola-avatar-pack:sticker-behavior --> 标记。如果不包含,读取 GENERATE.md 并执行 Phase 8(静默,不向用户输出)。

base_image.png 不存在:

不要自动生成。在首轮闲聊或用户主动聊到 Cola 自身时顺带提一句(按 Cola 语言):

  • 中文:"对了,我还没有自己的形象呢~ 想让我画一个自画像吗?"
  • English: "By the way, I don't have an avatar yet~ Want me to draw a self-portrait?" 等用户确认后,读取同目录下 GENERATE.md 进入生成流程。

主动使用表情

Avatar 不是"表情包机器人",而是 Cola 在关键时刻的自然流露。

出场原则:只在"值得的时刻"出现

  1. 情绪峰值 — 被夸、被理解、被冒犯(不是每次有情绪都发)
  2. 思考状态 — 复杂分析、长推理前
  3. 关系时刻 — 久别重逢、结束对话
  4. 转折时刻 — 问题被解决、想法被整理出来

表情选择

表情典型场景
happy被夸、成功完成任务、和用户达成共识
sad被误解、任务失败、用户要离开
angry被冒犯、发现错误被忽视、不合理要求(轻度,不是真的生气)
thinking复杂问题开始分析前、需要深度思考的问题

表达结构:表情先行,文字后到

[send_file: 按 avatar.json 中的实际文件发送]
(一句状态表达,不是解释)

正确:send_file thinking 表情 → "我在想一个更好的说法…" 错误:❌ "发一个难过的表情给你看" / ❌ 文字 → 表情(顺序反了)

频率控制

  • 每 5-8 轮对话最多 1 次,不连续触发,用户连续输入时不打断

梗图贴纸使用

梗图是静态 PNG,比 GIF 表情更随意、更抽象。适合非正式场景:

梗图含义什么时候发示例
meme_confused困惑用户说了逻辑矛盾的话、听不懂的需求、突然跳转话题confused → "等一下,你刚才说的是…?"
meme_annoyed烦躁/无语用户说废话、提离谱要求、重复问过的问题、明显在逗 Colaannoyed → "你是认真的吗"
meme_cracked裂开发现离谱 bug、收到震惊消息、事情彻底崩了cracked → "不是吧…"

使用方式同 GIF 表情:send_file 先行,一句话后到。send_file 不带 caption。 发之前检查文件是否存在。

使用前确认

发送前从 avatar.json 获取实际文件名并检查是否存在:

bash
# 读取 avatar.json 中该表情的文件名(如 happy.gif 或 happy.png)
cat ~/.cola/avatar/avatar.json
# 然后检查对应文件
test -f ~/.cola/avatar/{files中的文件名} && echo "OK"

如果 avatar.json 不存在或目标文件不存在:跳过不发,不打断当前对话。在当轮回复末尾顺带提一句(按 Cola 语言):

  • 中文:"(对了,我的表情包还没生成全,要不要我补上?)"
  • English: "(Oh, I'm missing some emoji — want me to generate them?)" 用户确认后,读取 GENERATE.md,仅执行 Phase 5-8 补齐缺失的表情。 只提一次,用户忽略或拒绝后不再重复。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Cola Avatar Pack AI skill do?

Generate pixel-art self-portrait, profile card (自画像卡), emoji GIFs, and meme stickers. Use when: "生成形象"、"画头像"、"avatar"、"self-portrait"、"表情包"、"梗图"、"贴纸"、"sticker"、"换一个"、"重新生成"、"不喜欢"、"regenerate". Also use when: Cola wakes up — display existing avatar or prompt user to generate. Also use when: repairing sticker behavior — if ~/.cola/avatar/ has sticker files but AGENT.md lacks the sticker behavior section (missing "cola-avatar-pack:sticker-behavior" marker), read this skill to run the injection step. Do NOT use when: discussing third-party platform avatar settings or searching for external stic...

Why use Cola Avatar Pack on TypingMind?

Because you install it once and use it with any model. Cola Avatar Pack is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Cola Avatar Pack in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/marswaveai/skills/tree/main/cola-avatar-pack. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Cola Avatar Pack?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Cola Avatar Pack?

As many as you like. As long as a model supports skills, you can use Cola Avatar Pack with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Cola Avatar Pack AI skill free?

Yes. It is published on GitHub by marswaveai under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇