Icns Maker

将 PNG 图标转换为符合 macOS Big Sur+ 视觉与留白规范的标准 .icns 应用图标,支持单图转换与目录批量处理

260 stars 30 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add cafe3310/public-agent-skills --skill icns-maker
Manual install
git clone --depth 1 https://github.com/cafe3310/public-agent-skills.git /tmp/public-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/public-agent-skills/skills/icns-maker ~/.claude/skills/icns-maker

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 技能: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 图标明显大上一圈。
* 需要将包含多套不同尺寸(如 `*-16@1x.png` 到 `*-1024@1x.png`)的导出目录批量打包为各自独立的 `.icns`。

## 工作流程

### 1. 命令行调用

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

#### 单图转换
```bash
# 自动垫回透明留白(主体 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(如 `prefix-1024@1x.png`, `prefix-512@1x.png` 等),挑选最高分辨率文件作为 Master 进行生成:
```bash
# 批量处理整个导出目录
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. 底层标准与分辨率映射
Read the full skill on GitHub

Details

Skill name
icns-maker
Path
skills/icns-maker/SKILL.md
License
Apache-2.0
Repo updated
15 November 2026

FAQ

What does the Icns Maker skill do?

将 PNG 图标转换为符合 macOS Big Sur+ 视觉与留白规范的标准 .icns 应用图标,支持单图转换与目录批量处理

How do I install the Icns Maker skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add cafe3310/public-agent-skills --skill icns-maker. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Icns Maker popular?

It lives in cafe3310/public-agent-skills, which has 260 GitHub stars and 30 forks.

Related skills

Skill Creator

260

cafe3310/public-agent-skills

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Skill & Plugin AuthoringIn 1 list30

Impeccable

260

cafe3310/public-agent-skills

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Not for backend-only or non-UI tasks.

Frontend & DesignIn 2 lists30

Agent Browser

260

cafe3310/public-agent-skills

为 Agent 设计的自动化浏览器 CLI 工具,也能操作 Electron 桌面应用。当需要与网站交互(包括页面导航)时使用

AI, LLMs & Agents30

Im Wiki Extractor

260

cafe3310/public-agent-skills

将超长群聊日志转化为结构化知识图谱。采用滑动窗口增量提取,规避上下文限制,并确保实体与关系的沉淀与溯源

Other30

Gtm Tracking Plan

114

cognyai/claude-code-marketing-skills

Turn a measurement plan into a Google Tag Manager spec — tags, triggers, variables, and copy-paste dataLayer snippets for every event

OtherIn 3 lists16

Interactive Human Review

260

cafe3310/public-agent-skills

大范围变更后的互动式人类 review 流程,通过渐进式 checklist 与问答交互确保人类深度理解会话改动

Other30

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.