Agent skill

Oil Icon

生成风格统一的图标集合，通过宫格生图、切分和去背景交付透明 PNG。用户需要成套自定义图标、栏目图标或匹配品牌风格的图标时使用；不用于单个简单矢量图标或小尺寸密集功能符号。

Install Oil Icon

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .claude/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .agents/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .cursor/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .gemini/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .github/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oil-oil/oil-icon --skill oil-icon -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install oil-oil/oil-icon oil-icon --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "oil-icon" agent skill from https://github.com/oil-oil/oil-icon/tree/main into .opencode/skills/oil-icon/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oil-icon", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: oil-icon
GitHub stars: 303
Token cost: ~1.5k tokens
SKILL.md length: 794 words
Files: 104 (incl. scripts, references, assets)
Skills in repo: 1
Repo updated: Sep 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Works in 7 steps: Choose the style. Either pick a built-in… → List the icons. Write each concept as… → Compose the prompt. style.preamble + the… → …
Tasks that involve Image generation
SKILL.md covers API Key 配置入口, Workflow, Built-in styles and Key rules (see…
Calls python3

What it does

Oil Icon is an agent skill from oil-oil/oil-icon. 生成风格统一的图标集合，通过宫格生图、切分和去背景交付透明 PNG。用户需要成套自定义图标、栏目图标或匹配品牌风格的图标时使用；不用于单个简单矢量图标或小尺寸密集功能符号。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 108 other files, including scripts, reference files and assets (for example `.github/workflows/credential-ui.yml` and `README.md`).

It sits in Media & Creative, covering Image generation. The repository describes itself as: 生成风格一致的图标集合，完成宫格切分、背景去除和逐个检查，交付透明 PNG。 The licence is MIT.

When your agent uses it

Tasks that involve Image generation

Example prompts

“/oil-icon”

Requirements

Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

Choose the style. Either pick a built-in from styles/ (table below), or match the user's brand by reading their project's design tokens /…
List the icons. Write each concept as name — short concrete metaphor (e.g. settlement — a wallet with a coin). One clear idea per icon…
Compose the prompt. style.preamble + the style's construction fields (as short guidance) + palette-lock line + numbered metaphors + the…
Generate the sheet(s). Choose an image provider by capability, in order (see reference/image-providers.md) — never assume Codex is present
Slice. Run scripts/setup.sh once, then
QA (mandatory). Composite the sliced PNGs onto a contrasting colour (e.g. magenta) and check every icon for (a) a fragment bled in from a…
Deliver the transparent PNGs, organized and named.

What it can do on your machine

Read from SKILL.md and the folder at commit afb2007. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Oil Icon loads about 1.5k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 24 tokens; SKILL.md has 794 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~24
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from oil-oil/oil-icon at commit afb2007, republished under its MIT licence (© oil-oil). 794 words, ~1,485 tokens.

Download SKILL.mdSave it as .claude/skills/oil-icon/SKILL.md (or your agent's skills folder). This skill also uses 103 other files; get the full folder from GitHub.

name: oil-icon
description: 生成风格统一的图标集合，通过宫格生图、切分和去背景交付透明 PNG。用户需要成套自定义图标、栏目图标或匹配品牌风格的图标时使用；不用于单个简单矢量图标或小尺寸密集功能符号。

oil-icon

Generate a set of icons that share one visual style, output as transparent PNGs.

Image generation runs on a flat grey backdrop as a 4×4 sheet — 16 icons in one generation, 有助于统一风格，但仍需逐个检查 — then each cell is sliced out and background-removed.

Agent owns the design decisions (which style, which palette, which metaphors, whether to match a brand); image generation and slicing are mechanical steps.

API Key 配置入口

需要外部服务凭据时先读API Key 配置与业务读取：复用已有安全入口；本机缺少 Key 时使用随附固定页面，保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。

Workflow

Choose the style. Either pick a built-in from styles/ (table below), or match the user's brand by reading their project's design tokens / assets and deriving a custom style-spec — see reference/style-adaptation.md. Freeze the result as a style-spec with the same fields as the built-in JSONs; 后续批次复用同一规范，并检查生成偏差.
List the icons. Write each concept as name — short concrete metaphor (e.g. settlement — a wallet with a coin). One clear idea per icon; keep the detail level consistent across the set. 默认每张 16 格；明确选择 9 格时，提示词使用 3×3，切图命令必须同时传 --grid 3。 If the user asks for an exact count below 16, still use a 4x4 / 16-cell sheet: place the requested icons first in row-major order, then explicitly ask the remaining cells to stay empty grey background.
Compose the prompt. style.preamble + the style's construction fields (as short guidance) + palette-lock line + numbered metaphors + the fixed composition text — see reference/prompt-template.md and reference/construction.md.
Generate the sheet(s). Choose an image provider by capability, in order (see reference/image-providers.md) — never assume Codex is present:
1. Built-in / host imagegen first — if the running agent already has a callable image-generation tool, including Codex's built-in image_gen tool or the imagegen skill, call it directly. Do not delegate to external Codex CLI just to reach imagegen from another process.
2. Codex CLI fallback — only if this agent has no callable image-generation tool, and Codex is available （从可用 Skill 清单定位 codex，或使用 PATH 中已有的 codex）, delegate generation to it.
3. External API fallback — only if neither of the above exists, 沿用用户已授权的供应商；缺少凭据时按配置说明打开随附页面，不索要聊天中的 Key; for OpenAI Images, scripts/gen_image.py --prompt "…" --out raw/<style>.png is ready. Save or copy each generated sheet to raw/<style>.png on flat grey #808080. Built-in imagegen may save under $CODEX_HOME/generated_images/...; after generation, move or copy the selected PNG into the task output raw/ folder. 同一张图更容易保持共同风格，但仍须逐个验收，不能把一次生成视为一致性保证； a provider only has to turn the prompt into a grey-background PNG.
Slice. Run scripts/setup.sh once, then: .venv/bin/python3 scripts/slice_icons.py <raw>.png <outdir> --mode <cutout> [--thresh N] [--grid 4] [--count N] using the style's cutout mode (floodfill for flat/hard-edge, rembg for soft / 3D / glossy / photo).
QA (mandatory). Composite the sliced PNGs onto a contrasting colour (e.g. magenta) and check every icon for (a) a fragment bled in from a neighbouring cell, (b) leftover grey, and (c) consistency against the style's construction — uniform stroke, one radius, matched detail level, shared parts, motif present, single perspective, and no accent out-weighting the defining element (in line styles the accent must be lighter and smaller than the stroke). Re-slice or regenerate any that fail — never ship an icon carrying part of the one above it.
Deliver the transparent PNGs, organized and named.

Show full SKILL.md (293 more words)Show less

Built-in styles

style	look	cutout	fits
linear	mono line / outline	floodfill	utility, settings
filled	solid single-colour glyphs	floodfill	mobile nav / tab bars
colorblock	bold flat multi-colour blocks	floodfill	kids, creative
cartoon	sticker-style cartoon	rembg	games, entertainment
isometric	isometric 3D miniatures	rembg	SaaS, dashboards
render3d	glossy puffy 3D	rembg	rewards, onboarding
sticker	die-cut glossy vinyl	rembg	social, reactions
realistic	photoreal product renders	rembg	e-commerce, hero
animal-badge	animal emblems in badges	rembg	avatars, kids

Each styles/<name>.json holds the preamble, locked palette, cutout mode, threshold, construction system, and what it fits.

Key rules (see `reference/design-rules.md`)

Lock the palette as hex in the spec — colourful styles drift run-to-run otherwise.
Never make black filled icons — near-black / black may be used as a thin outline or line stroke, but never as the dominant filled mass of an icon set. If the brand foreground is black, map it to strokes only; for filled or duotone styles, choose a mid-light brand colour for the main shape and keep dark colours small.
Start from the real product context — when a user gives a live site, screenshot, mascot, logo, or brand asset, derive the icon concepts and construction from that source first. Do not jump straight into generic style families such as isometric, duotone, 3D, or colorblock; those are finishes applied after the product motif, real navigation, and real feature names are locked.
Slicing drops neighbour bleed — the slicer keeps only the centred icon per cell.
Cutout by edge type — flat/hard-edge → floodfill; soft / 3D / glossy / photo → rembg.
Design sophistication comes from a construction system + a brand motif, not from tinting a generic set — each style's construction object encodes the grid, stroke, radius, detail budget, shared parts, and motif (see reference/construction.md). A rigorous system ultimately wants vector; raster is for direction and spot icons.

Files

SKILL.md and 103 other files (scripts, references, assets) in the repository root of oil-oil/oil-icon.

SKILL.md
.github/workflows/credential-ui.yml
.gitignore
LICENSE
README.md
assets/readme/made-with-beautify.svg
assets/readme/readme-hero.png
assets/readme/readme-section-consistency.svg
assets/readme/readme-section-start.svg
assets/readme/readme-section-styles.svg
assets/readme/readme-section-what.svg
assets/readme/readme-section-workflow.svg
assets/readme/showcase-isometric/01.png
assets/readme/showcase-isometric/02.png
assets/readme/showcase-isometric/03.png
assets/readme/showcase-isometric/04.png
… and 88 more

Open the folder on GitHubat commit afb2007

Compare with similar skills

Oil Icon next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oil Icon compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Oil Icon this skilloil-oil/oil-icon	303	—	~1.5k	Automated safety check: Pass	MIT	1 mo ago
AI Image Generation and Editingzhayujie/CowAgent	47k	—	~1.3k	Automated safety check: Pass	MIT	yesterday
Structured Image Generationbytedance/deer-flow	84k	4 repos	~2.9k	Automated safety check: Pass	MIT	today
Canghe Comicfreestylefly/canghe-skills	461	8 repos	~3.2k	Automated safety check: Pass	None	4 mo ago
Generate Imageynulihao/AgentSkillOS	618	10 repos	~1.7k	Automated safety check: Notes	None	7 mo ago
GPT Image Generation CLIwuyoscar/GPT-Image2-Skill	5.7k	—	~2.5k	Automated safety check: Notes	MIT	11 days ago

Similar skills

AI Image Generation and Editing
zhayujie/CowAgent
Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.
47k GitHub stars~1.3k tokensUpdated yesterday
Media & CreativeAuto-check passed
Structured Image Generation
bytedance/deer-flow
Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.
84k GitHub starsUsed in 4 repos~2.9k tokens
Media & CreativeAuto-check passed
Canghe Comic
freestylefly/canghe-skills
Knowledge comic creator supporting multiple art styles and tones.
461 GitHub starsUsed in 8 repos~3.2k tokens
Media & CreativeAuto-check passed
Generate Image
ynulihao/AgentSkillOS
Generate or edit images using AI models (FLUX, Gemini). An agent skill from ynulihao/AgentSkillOS.
618 GitHub starsUsed in 10 repos~1.7k tokens
Media & CreativeAuto-check: notes
GPT Image Generation CLI
wuyoscar/GPT-Image2-Skill
Generates and edits images with GPT Image 2 or 2.5 through a packaged CLI and a prompt gallery, after settling which model fits the request.
5.7k GitHub stars~2.5k tokensUpdated 11 days ago
Media & CreativeAuto-check: notes
Minimal Zine Poster Generator
LiamGvchi/gc-minimal-zine-poster
Creates or analyzes quiet, paper-texture zine posters with big negative space, one color accent and experimental type, returning an image prompt and the generated poster.
7.3k GitHub stars~2.9k tokensUpdated 1 mo ago
Media & CreativeAuto-check passed

Questions about Oil Icon

What does Oil Icon do?

生成风格统一的图标集合，通过宫格生图、切分和去背景交付透明 PNG。用户需要成套自定义图标、栏目图标或匹配品牌风格的图标时使用；不用于单个简单矢量图标或小尺寸密集功能符号。. Oil Icon is an agent skill from oil-oil/oil-icon.

When should I use Oil Icon?

Oil Icon fits situations like: tasks that involve Image generation.

How do I install Oil Icon in Claude Code?

Run `npx skills add oil-oil/oil-icon --skill oil-icon -a claude-code`. Or copy the skill folder (the oil-oil/oil-icon repository) into .claude/skills/oil-icon in your project. Claude Code loads it when a task matches its description.

How do I install Oil Icon in Codex?

Run `npx skills add oil-oil/oil-icon --skill oil-icon -a codex`. Or copy the skill folder (the oil-oil/oil-icon repository) into .agents/skills/oil-icon in your project. Codex loads it when a task matches its description.

Can I use Oil Icon in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oil-oil/oil-icon --skill oil-icon -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oil-icon, .gemini/skills/oil-icon, .github/skills/oil-icon and .opencode/skills/oil-icon in your project.

What does Oil Icon need to run?

Going by SKILL.md and its folder, Oil Icon needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Oil Icon access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Oil Icon safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Oil Icon use?

Oil Icon is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Oil Icon use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 972 tokens, read only when the agent opens those files.

What are the alternatives to Oil Icon?

Skills that share tags, products or a category with Oil Icon: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), Structured Image Generation (bytedance/deer-flow, 84k stars), Canghe Comic (freestylefly/canghe-skills, 461 stars) and Generate Image (ynulihao/AgentSkillOS, 618 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oil Icon?

oil-oil (a GitHub user) maintains it in oil-oil/oil-icon, which has 303 GitHub stars. The repository was last updated on September 10, 2026.

Source: oil-oil/oil-icon on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Oil Icon

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

oil-icon

API Key 配置入口

Workflow

Built-in styles

Key rules (see reference/design-rules.md)

Files

Compare with similar skills

Similar skills

AI Image Generation and Editing

Structured Image Generation

Canghe Comic

Generate Image

GPT Image Generation CLI

Minimal Zine Poster Generator

Related

Questions about Oil Icon

Key rules (see `reference/design-rules.md`)