oil-icon is an AI Agent skill that generates a cohesive set of 16 transparent PNG icons in a single generation, ensuring consistent style, color, and visual motifs.

Stars

129

7-day growth

No data

Forks

14

Open issues

1

License

MIT

Last updated

2026-07-13

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the problem of style drift when generating icons one by one by creating all icons together with predefined rules, and offers 9 built-in presets plus brand-adaptation capabilities.

Who it is for

  • AI Agent developers and users
  • Product and UI/UX designers
  • Teams needing quick, consistent icon sets for apps or websites
  • Developers building demos or MVPs

Use cases

  • Generating functional icons for product features and categories
  • Creating marketing cards and empty-state illustrations
  • Producing themed icon sets for brand-adapted interfaces
  • Making consistent icons for SaaS dashboards or onboarding flows

Strengths

  • Guarantees visual consistency across all icons (line width, color, perspective, motifs)
  • Supports 9 diverse built-in styles (linear, filled, 3D, isometric, etc.)
  • Automatically slices a 4×4 grid into individual transparent PNGs and removes backgrounds
  • Can adapt to existing brand assets (screenshots, logos) or start from a text description

Considerations

  • Not suitable for very small button icons (16–24px); vector libraries like Lucide are recommended
  • Depends on the Agent's available image generation capabilities (may fall back to other methods)
  • Soft-edged styles (3D, stickers) require an additional background removal model for clean transparency

README quick start

oil-icon 是一个给 Agent 使用的图标生成 Skill。我们只需要说明想要哪些图标、喜欢什么风格,或把项目的配色和页面交给它,它会生成一整套风格统一、背景透明、可以直接使用的 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

Description

Generate cohesive transparent-background icon sets from 4x4 image sheets

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482