Skip to content

Oil Icon

AI icon set generator skill for Claude Code & Codex. 帮你生成整套风格统一的图标。

Install

$npx skills add oil-oil/oil-icon
Claude Code
claude mcp add oil-icon -- npx skills add oil-oil/oil-icon
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "oil-icon": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "oil-oil/oil-icon"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

生成风格一致的图标集合,完成宫格切分、背景去除和逐个检查,交付透明 PNG。

上面的两组图标使用了完全相同的 16 个概念:配色、网格、魔法棒、图层、品牌、标签、卡片、分类、空状态、营销、产品、角色、切图、透明背景、质检和导出。改变的是整套的画法,因此一组是柔软 3D,另一组是等轴微缩。

它适合产品功能、分类、营销卡片、空状态和品牌化插图;如果只是制作 16–24px 的按钮小图标,直接使用 Lucide 等矢量图标库会更合适。

让模型一张一张画,后面的图标很容易忘记前面的线宽、圆角、视角和颜色。oil-icon 把 16 个图标放在同一次生成里,让模型始终看见整套作品;开始画之前,还会先把共同的规则定清楚。

一套图标会共同遵守:

  • 同一套画法:网格、视角、线宽、圆角和繁简程度一致。
  • 同一套颜色:色值直接锁定,避免每一批越画越艳、越画越偏。
  • 同一个记号:反复出现的小火花、切角或其他母题,让图标拥有自己的身份。
  • 同一次生成:16 个图标共享同一段视觉上下文,比逐张生成更容易保持一致。

所以它不是给通用图标换一套颜色,而是先把整套的画法定清楚,再让模型按照这些规则画完。

图标清单 + 风格或项目素材
          ↓
定好颜色、视角、圆角和专属记号
          ↓
在纯灰背景生成一张 4×4 图标图
          ↓
自动切成 16 张图片并移除背景
          ↓
在高对比底色检查灰边、串格和一致性
          ↓
交付 16 张透明 PNG

硬边图标使用颜色识别清除背景,3D、贴纸等软边图标使用背景移除模型。切图程序只保留每个格子中心的主体,避免把旁边图标的碎片一起带走。

仓库里现在有 9 种内置预设,每一种都有自己的色彩、构造规则和背景移除方式:

预设 视觉特点 更适合
linear · 线性 单色描边、统一线宽、圆角收笔 工具、设置和内容密集的界面
filled · 面性单色 清楚的实心轮廓,只使用一种主色 导航、标签栏和小面积强调
colorblock · 撞色 2~3 种颜色组成简洁的几何色块 创意、教育和轻松活泼的产品
cartoon · 卡通 粗描边、圆润造型和贴纸感 游戏、娱乐和角色化内容
isometric · 等轴微缩 统一视角的立体小物件,结构清楚 工作台、功能介绍和 SaaS 产品
render3d · 3D 渲染 柔软膨胀的形状、糖果色和细腻材质 引导、奖励、会员和营销卡片
sticker · 贴纸 清楚的外轮廓、亮面材质和独立贴纸造型 社区、聊天、表情和活动素材
realistic · 真实实物 接近产品摄影的真实物体 电商、商品分类和首屏展示
animal-badge · 动物徽标 动物角色与统一徽章结构结合 头像、儿童产品和角色系统

这 9 种只是随仓库提供的稳定起点,不是 oil-icon 能做的全部风格。我们还可以:

  • 直接修改预设:替换配色,调整线宽、圆角、视角、材质和细节多少。
  • 匹配现有品牌:读取网站、Logo、截图和设计变量,把真实的颜色与形状规则整理成一套图标风格。
  • 从文字描述开始:没有现成设计也没关系,可以先用一句话确定方向,再生成第一张风格样板。
  • 保存专属规则:风格确认后,把色板、构造方式和专属记号固定下来,之后继续生成的新图标也会沿用同一套规则。

内置预设解决的是快速开始,品牌适配解决的是让图标真正属于这个产品。

方式一 · 执行命令

npx skills add oil-oil/oil-icon

方式二 · 直接交给 Agent

把下面这句话发给任何支持 Skill 的 Agent:

请安装这个 Skill:https://github.com/oil-oil/oil-icon

安装完成后,可以直接描述图标清单和使用场景:

[$oil-icon] 根据这个产品的页面和配色,生成一套 16 个功能图标。

如果没有现成品牌,也可以指定一个方向:

[$oil-icon] 为我的 AI 写作工具生成一套柔软 3D 图标,包含创作、改写、翻译、素材、历史和导出。

oil-icon 会优先使用 Agent 当前可用的图片生成能力;没有内置图片工具时,再根据环境选择其他生成方式。切图与检查流程保持一致。

仓库里有什么

  • SKILL.md:完整工作流与执行规则
  • styles/:内置风格和构造规范
  • reference/:提示词、品牌适配、图标设计与生成说明
  • scripts/:环境安装、切图和背景移除工具

License

MIT

配置、依赖与使用边界

依赖已授权的生图工具;切图需 scripts/setup.sh 安装的 Python 图像依赖。软边缘风格按需使用 rembg。无需把 Key 发到聊天。

产物保存在任务目录。9 格使用 --grid 3,16 格使用 --grid 4;小尺寸功能图标优先矢量库。一次生成不保证一致性。

使用示例:

用 oil-icon 为这六个功能画一组配套图标。

API Key 配置页面

首次使用外部服务时,可以在本机配置页亲自填写 Key;已有配置会复用,密钥存入系统凭据库。只为实际使用的外部服务配置;纯本地处理不需要 Key。页面需要 Node.js 22.18+ 与可用的系统凭据服务,业务运行仍使用原依赖。

安装、状态检查、打开页面和带凭据运行的完整入口见配置说明。页面保存与业务读取已经接通;不把 Key 发进聊天,也不自动迁移旧文件。

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

Explore related