A tool for converting PNG images into macOS .icns application icons. It can add suitable transparent spacing and package one image or a folder of different-size images.

Use it to turn a 1024-pixel PNG or a set of exported icon images into a macOS application icon file.

A PNG is a general image file, while .icns is the icon format macOS applications use. The conversion helps prevent exported artwork from appearing too large in the Dock or Finder.

icns-maker — Skill for Claude Code and Codex by cafe3310

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add cafe3310/public-agent-skills --skill icns-maker

Clone the repo

git clone --depth 1 https://github.com/cafe3310/public-agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/icns-maker/github.svg)](https://agentmods.dev/skills/cafe3310/public-agent-skills/icns-maker)

Your own site

<a href="https://agentmods.dev/skills/cafe3310/public-agent-skills/icns-maker"><img src="https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/icns-maker/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/cafe3310/public-agent-skills/icns-maker"><img src="https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/icns-maker.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,297 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00041	$0.01297
Opus 5.5	$0.00016	$0.00519
Sonnet 5.5	$0.00008	$0.00259
Haiku 4.5	$0.00004	$0.00130

Measured 2d ago against content hash 572c6ff3ae11, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

icns-maker scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/make_icns.py, scripts/run.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/icns-maker/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

技能：icns-maker

概述

此技能将 PNG 图标转换为符合 macOS 现代设计规范的 .icns 格式。

自 macOS Big Sur 起，系统图标采用了统一的 Squircle（连续圆角矩形）视觉网格。在 1024×1024 像素的画布中，实体主体推荐尺寸约为 824×824 像素，四周预留约 100px 的透明外边距（Margin / Padding）。直接将撑满 1024×1024 画布的全出血（Full-bleed）图像压制为 .icns 会导致图标在 Dock 和 Finder 中视觉明显膨胀、过大。

本技能通过 macOS 自带的 sips 与 iconutil 自动进行主体缩放、边缘透明垫补，并生成标准的 10 阶分辨率 .iconset 打包为 .icns。

关键词: macOS 图标, icns, iconset, iconutil, sips, 边距补正, Big Sur, 图标制作

何时使用此技能

从 Figma、Sketch 或 Icon Composer 导出了全出血的 1024×1024 PNG 图标，需要制作合成 .icns。
发现现有的 .icns 在 macOS Dock 或应用程序列表中比系统自带 App 图标明显大上一圈。
需要将包含多套不同尺寸（如 *[email protected] 到 *[email protected]）的导出目录批量打包为各自独立的 .icns。

工作流程

1. 命令行调用

本技能脚本统一放置在 scripts/ 目录下，提供 Python 原生脚本与 Shell 便捷入口。

单图转换

# 自动垫回透明留白（主体 824px，外扩回 1024px），在同目录生成 AppIcon.icns
python3 <path_to_skill>/scripts/make_icns.py AppIcon.png

# 指定输出文件路径
python3 <path_to_skill>/scripts/make_icns.py AppIcon.png -o /path/to/output.icns

目录批量处理

当指定一个目录时，脚本会自动聚合同组的多分辨率 PNG（如 [email protected], [email protected] 等），挑选最高分辨率文件作为 Master 进行生成：

# 批量处理整个导出目录
python3 <path_to_skill>/scripts/make_icns.py ~/Downloads/my-icons/

# 或通过 shell 包装脚本
/bin/bash <path_to_skill>/scripts/run.sh ~/Downloads/my-icons/

2. 常用参数

--subject-size <N>：主体在 1024 画布中的缩放尺寸，默认 824。
--full-bleed：原图若已内嵌留白，开启此参数将不额外添加透明外边距。
-b, --backup：若目标 .icns 文件已存在，先将其备份到 backup_fullbleed_icns/ 目录再替换。
-v, --verbose：输出每一步处理的详细日志。

3. 底层标准与分辨率映射

生成的 .iconset 包含 Apple 规范所要求的全套 10 阶资产：

icon_16x16.png (16×16)
[email protected] (32×32)
icon_32x32.png (32×32)
[email protected] (64×64)
icon_128x128.png (128×128)
[email protected] (256×256)
icon_256x256.png (256×256)
[email protected] (512×512)
icon_512x512.png (512×512)
[email protected] (1024×1024)

最终调用 iconutil -c icns <name>.iconset -o <name>.icns 完成二进制打包，并自动清理中间 .iconset 目录。

最佳实践

源图要求：尽量提供 1024×1024 像素、带透明通道（Alpha）的高清 PNG 格式源图。
圆角注意：若源图是带 Squircle 圆角的矩形，请确保背景是透明而非纯白色；如果原图不是圆角，在未做遮罩前补边距仍会保留方角。
安全替换：如果是在既有项目或导出目录中重新压制图标，建议加上 -b 参数以保留原始 .icns 备份。

Read the full file on GitHub · 89 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 89 lines · 41 tokens per session scan A 572c6ff3ae11

Subscribe to this mod's changes

icns-maker is a skill published in the GitHub repository cafe3310/public-agent-skills (256 stars, last pushed yesterday), licensed Apache-2.0. It adds 41 tokens to every session and 1,297 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-05.

Design and UX agent-skill-repository gemini-cli skills

icns-maker next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
icns-makercafe3310/public-agent-skills	Skill	256	yesterday	Apache-2.0	A	41	Claude Code, Codex
google-fonts-curatorflc1125/skills	Skill	39	yesterday	MIT	A	61	Claude Code, Codex
preview-svgveelenga/preview-skills	Skill	9	18d ago	MIT	A	107	Claude Code
android-ui-engineeringGuillemRoca/agent-skills-android	Skill	5	1mo ago	MIT	A	52	Claude Code
android-accessibilityGuillemRoca/agent-skills-android	Skill	5	1mo ago	MIT	A	35	Claude Code
design-taste-frontendfirstsun-dev/skills	Skill	5	4d ago	none	A	61	Claude Code, Codex
imagegen-frontend-mobilefirstsun-dev/skills	Skill	5	4d ago	none	A	126	Claude Code, Codex