Skip to content

KKenny0/card-skill / plugins/card-skill/skills/card-skill

card-skill

Unverified

Turn supplied text or evidence into PNG cards, article covers, and explanatory illustrations. Use for content-to-image requests, including card series and reading-note visuals.

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown18.7 KB
README.zh-CN.mdmarkdown18.2 KB
SKILL.mdskill md13.7 KB
VERSIONother7 B
assets/big_template.htmlother2.0 KB
assets/capture4k.jsscript5.7 KB
assets/comic_template.htmlother1.8 KB
assets/cover-series/paper-wilderness/README.mdmarkdown1.5 KB
assets/cover-series/paper-wilderness/cooperation.pngbinary2.1 MB
assets/cover-series/paper-wilderness/layout.cssother523 B
assets/cover-series/paper-wilderness/master.pngbinary1.7 MB
assets/cover-series/paper-wilderness/rest.pngbinary2.3 MB
assets/cover-series/paper-wilderness/uncertainty.pngbinary2.0 MB
assets/fonts/DM-Sans-OFL.txtmarkdown4.3 KB
assets/fonts/DM-Serif-Display-OFL.txtmarkdown4.4 KB
assets/fonts/DMSans-Variable.ttfbinary234.5 KB
assets/fonts/DMSerifDisplay-Regular.ttfbinary74.8 KB
assets/fonts/FONT_SOURCES.mdmarkdown1.3 KB
assets/fonts/JetBrains-Mono-OFL.txtmarkdown4.3 KB
assets/fonts/JetBrainsMono-Variable.ttfbinary293.1 KB
assets/fonts/LICENSE-fonts.mdmarkdown1.7 KB
assets/fonts/NanxiChuxiasong.ttfbinary3.1 MB
assets/fonts/OFL-1.1.txtmarkdown4.0 KB
assets/fonts/XiangcuiDengcusong.ttfbinary22.3 MB
assets/fonts/local-fonts.cssother641 B
assets/fonts/香萃打字机体 W15.ttfbinary15.7 MB
assets/fonts/香萃打字机体 W40.ttfbinary15.5 MB
assets/gallery/article-boundary-legacy.pngbinary129.8 KB
assets/gallery/article-formula.pngbinary181.2 KB
assets/gallery/article-personal.pngbinary120.8 KB
assets/gallery/big.pngbinary157.0 KB
assets/gallery/comic.pngbinary3.4 MB
assets/gallery/editorial-wechat-cover.pngbinary760.3 KB
assets/gallery/infograph.pngbinary604.6 KB
assets/gallery/long.pngbinary960.7 KB
assets/gallery/manifest.jsonconfig6.2 KB
assets/gallery/poster.pngbinary335.6 KB
assets/gallery/reading-notes.pngbinary363.9 KB
assets/gallery/reading-report.pngbinary366.9 KB
assets/gallery/sketchnote.pngbinary603.9 KB
assets/gallery/whiteboard.pngbinary583.2 KB
assets/infograph-comparison-notes.cssother951 B
assets/infograph_template.htmlother2.6 KB
assets/logo.pngbinary1.0 MB
assets/long_template.htmlother3.1 KB
assets/open-source-tool/tool-cli-1.pngbinary419.5 KB
assets/open-source-tool/tool-cli-2.pngbinary427.9 KB
assets/open-source-tool/tool-cli-3.pngbinary467.6 KB
assets/open-source-tool/tool-launch-1.pngbinary483.1 KB
assets/open-source-tool/tool-launch-2.pngbinary408.5 KB
assets/open-source-tool/tool-launch-3.pngbinary547.6 KB
assets/open-source-tool/tool-launch-4.pngbinary449.0 KB
assets/poster_template.htmlother18.5 KB
assets/readme-showcase.pngbinary773.4 KB
assets/sketchnote-wandering-notes.cssother1.7 KB
assets/sketchnote_template.htmlother16.9 KB
assets/whiteboard-notes.cssother2.2 KB
docs/astra-migration.mdmarkdown4.4 KB
docs/current-architecture.mdmarkdown7.8 KB
evals/agent-cases.jsonconfig34.0 KB
evals/cardbench-results.jsonconfig19.5 KB
evals/check-assertions.mjsscript25.8 KB
evals/check-job-assertions.mjsscript25.3 KB
evals/cover-art-agent-cases.jsonconfig4.5 KB
evals/evals.jsonconfig51.3 KB
evals/fixtures/article-diagram-personal.jsonconfig11.4 KB
evals/fixtures/big-reading.jsonconfig3.7 KB
evals/fixtures/comic-moment-notes/interaction.pngbinary2.2 MB
evals/fixtures/comic-moment-notes/jobs.mjsscript2.9 KB
evals/fixtures/comic-moment-notes/rousseau.pngbinary2.1 MB
evals/fixtures/comic-moment-notes/uncertainty-art.pngbinary1.6 MB
evals/fixtures/font-load-failed.htmlother830 B
evals/fixtures/infograph-comparison-notes/a2a.jsonconfig5.3 KB
evals/fixtures/infograph-comparison-notes/cursor.jsonconfig4.4 KB
evals/fixtures/infograph-comparison-notes/dense.jsonconfig7.1 KB
evals/fixtures/infograph-comparison-notes/interaction.jsonconfig6.3 KB
evals/fixtures/infograph-comparison-notes/loading.jsonconfig5.4 KB
evals/fixtures/infograph-comparison-notes/metrics.jsonconfig4.4 KB
evals/fixtures/infograph-comparison-notes/overview.jsonconfig6.9 KB
evals/fixtures/infograph-comparison-notes/stability.jsonconfig4.6 KB
evals/fixtures/long-notes.jsonconfig9.5 KB
evals/fixtures/poster-field-notes.jsonconfig2.2 KB
evals/fixtures/retired-cover-pair.jsonconfig7.5 KB
evals/fixtures/sketchnote-wandering-notes/a2a.jsonconfig6.3 KB
evals/fixtures/sketchnote-wandering-notes/rousseau.jsonconfig5.1 KB
evals/fixtures/sketchnote-wandering-notes/uncertainty.jsonconfig5.1 KB
evals/fixtures/svg-text-outside-viewbox.htmlother1.3 KB
evals/fixtures/svg-text-overflow.htmlother1.0 KB
evals/fixtures/whiteboard-notes-series.job.jsonconfig10.3 KB
evals/fixtures/whiteboard-notes.jsonconfig15.2 KB
evals/fresh-context-long-results.jsonconfig1.3 KB
evals/fresh-context-results.jsonconfig10.6 KB
evals/gallery/creative/comic.jsonconfig2.4 KB
evals/gallery/creative/infograph.jsonconfig4.4 KB
evals/gallery/creative/sketchnote.jsonconfig5.1 KB
evals/gallery/jobs/article-boundary-legacy.jsonconfig1.7 KB
evals/gallery/jobs/article-formula.jsonconfig2.0 KB
evals/gallery/jobs/article-personal.jsonconfig1.8 KB
evals/gallery/jobs/big.jsonconfig1.2 KB
evals/gallery/jobs/editorial-wechat-cover.jsonconfig2.1 KB
evals/gallery/jobs/long.jsonconfig5.1 KB
evals/gallery/jobs/poster.jsonconfig1.1 KB
evals/gallery/jobs/reading-notes.jsonconfig1.7 KB
evals/gallery/jobs/reading-report.jsonconfig1.2 KB
evals/gallery/jobs/whiteboard.jsonconfig3.0 KB
evals/run-discovery.mjsscript10.1 KB
evals/run-fresh-context.mjsscript26.1 KB
evals/runtime-policy.mjsscript1.3 KB
package-lock.jsonmanifest1.7 KB
package.jsonmanifest1.0 KB
references/article-diagram-personal.mdmarkdown5.6 KB
references/codex-inline-preview.mdmarkdown8.4 KB
references/cover-paper-wilderness.mdmarkdown5.9 KB
references/design-index.mdmarkdown3.7 KB
references/design-memory.jsonconfig154 B
references/eval-protocol.mdmarkdown11.2 KB
references/mode-article-diagram.mdmarkdown594 B
references/mode-big.mdmarkdown3.6 KB
references/mode-comic.mdmarkdown4.3 KB
references/mode-editorial-image.mdmarkdown3.0 KB
references/mode-infograph.mdmarkdown5.3 KB
references/mode-long.mdmarkdown4.2 KB
references/mode-poster.mdmarkdown12.3 KB
references/mode-sketchnote.mdmarkdown2.0 KB
references/mode-whiteboard.mdmarkdown1.8 KB
references/personal-style-migration.mdmarkdown2.8 KB
references/poster-field-notes.mdmarkdown3.3 KB
references/runtime.mdmarkdown2.9 KB
references/sketchnote-wandering-notes.mdmarkdown5.6 KB
references/source-material.mdmarkdown4.0 KB
references/source-open-source-tool.mdmarkdown5.1 KB
references/source-weread.mdmarkdown8.0 KB
references/taste.mdmarkdown15.0 KB
references/visual-job.mdmarkdown10.7 KB
references/visual-review.mdmarkdown4.7 KB
references/visual-taxonomy.mdmarkdown2.1 KB
references/whiteboard-reasoning-notes.mdmarkdown4.9 KB
schemas/article-diagram.jsonconfig5.1 KB
schemas/big.jsonconfig3.8 KB
schemas/comic.jsonconfig2.0 KB
schemas/editorial-image.jsonconfig8.5 KB
schemas/infograph.jsonconfig1.5 KB
schemas/long.jsonconfig6.5 KB
schemas/poster.jsonconfig13.8 KB
schemas/sketchnote.jsonconfig1.4 KB
schemas/visual-job.jsonconfig11.4 KB
schemas/visual-review.jsonconfig2.5 KB
schemas/whiteboard.jsonconfig8.5 KB
scripts/batch_render_covers.jsscript15.0 KB
scripts/batch_render_covers_dark.jsscript11.6 KB
scripts/card.jsscript22.4 KB
scripts/check-output.mjsscript57.4 KB
scripts/check-update.mjsscript32.7 KB
scripts/gallery-jobs.mjsscript12.5 KB
scripts/hash-reviewed-candidate.mjsscript799 B
scripts/lib/big-reading.jsscript3.0 KB
scripts/lib/candidate-snapshot.jsscript3.9 KB
scripts/lib/comic-art.jsscript958 B
scripts/lib/designs.jsscript9.3 KB
scripts/lib/escape.jsscript919 B
scripts/lib/file-access.jsscript10.6 KB
scripts/lib/long-notes.jsscript1.6 KB
scripts/lib/mode-selector.jsscript1.7 KB
scripts/lib/output-checks.jsscript26.0 KB
scripts/lib/personal-diagram.jsscript4.2 KB
scripts/lib/publish-artifacts.jsscript4.0 KB
scripts/lib/schema.jsscript31.5 KB
scripts/lib/test-kit.jsscript3.1 KB
scripts/lib/update-launcher.jsscript1.9 KB
scripts/lib/update-state.jsscript4.8 KB
scripts/lib/visual-job.jsscript39.5 KB
scripts/lib/visual-review.jsscript5.8 KB
scripts/lib/whiteboard-notes.jsscript5.8 KB
scripts/package-skill.mjsscript1.4 KB
scripts/publish-reviewed-job.mjsscript25.4 KB
scripts/render-job.mjsscript15.4 KB
scripts/renderers/article-diagram-personal.jsscript10.4 KB
scripts/renderers/article-diagram.jsscript133 B
scripts/renderers/big.jsscript5.6 KB
scripts/renderers/editorial-image.jsscript9.4 KB
scripts/renderers/long.jsscript5.9 KB
scripts/renderers/poster.jsscript12.3 KB
scripts/renderers/studio-composition.jsscript6.7 KB
scripts/renderers/whiteboard-notes.jsscript3.0 KB
scripts/renderers/whiteboard.jsscript104 B
scripts/setup-runtime.mjsscript2.7 KB
scripts/smoke.mjsscript8.5 KB
scripts/validate-big-reading.mjsscript3.5 KB
scripts/validate-comic-notes.mjsscript7.1 KB
scripts/validate-editorial-cover.mjsscript14.0 KB
scripts/validate-infograph-notes.mjsscript5.1 KB
scripts/validate-long-notes.mjsscript3.4 KB
scripts/validate-personal-defaults.mjsscript3.1 KB
scripts/validate-personal-diagram.mjsscript5.7 KB
scripts/validate-sketchnote-notes.mjsscript5.4 KB
scripts/validate-visual-job.mjsscript89.5 KB
scripts/validate-whiteboard-notes.mjsscript4.9 KB
scripts/validate.mjsscript100.2 KB

README.zh-CN.md

View on GitHub
<p align="center"><img src="assets/logo.png" alt="card-skill logo" width="112"></p>

Long 现在以“长页札记”为默认且唯一风格:连续正文、轻旁记、清楚的两级标题,以及显式声明的同源引文组。保留原文与出处,不自动合并相邻引文。

已确认的 mode 各自只保留一种个人风格,封面只保留纸上荒野。Poster 原有内容块统一采用个人札记;旧风格合同需迁移,见[迁移指南](references/personal-style-migration.md)。

<h1 align="center">card-skill</h1>

正文解释图请求默认采用六类个人关系布局,并用浏览器测量文字是否适配。参见[合同、适用边界与拆图规则](references/article-diagram-personal.md)。旧公式卡和 family 合同需重新规划。

<p align="center"><strong>把文章、观点和技术决策,做成可以直接发布的视觉卡片。</strong></p>

<p align="center">
  <a href="README.md">English</a> ·
  <a href="#它是什么">它是什么</a> ·
  <a href="#如何安装">安装</a> ·
  <a href="#快速示例">示例</a> ·
  <a href="#支持的格式">选格式</a> ·
  <a href="#faq">FAQ</a> ·
  <a href="#完整样张">样张</a>
</p>

## 它是什么

comic 现采用**片刻札记**:动作与镜头承担变化,保留干净纸面,并以同画面的无文字阅读检验叙事。可选 `comic_art` 通过正常检查与审核链封装概念插画;SVG 自由构图继续支持。

**card-skill** 是专为 coding agent(Claude Code、Codex、OpenCode、Pi 等)打造的视觉卡片生成 skill。输入文章、笔记、观点或技术决策,它能自动生成排版工整、可直接发布的 PNG 卡片。

与普通 AI 生图(容易生成难以预测的插画)不同,card-skill 专注于**信息层级、文字排版与结构化推演**。所有卡片均通过本地无头浏览器确定性渲染,并在导出前执行自动质量检查,呈现统一的纸质质感(**Kenny Style**)。

### 核心场景
- **编辑封面:** 公众号头图、博客封面与带有隐喻的氛围图。
- **正文解释图与白板:** 把复杂论证、因果链条和技术权衡压制成结构清晰的卡片。
- **社媒系列卡片:** 将长观点拆解为适合小红书或社交平台的连贯多卡或长阅读卡。

*(它不是 UI 界面设计器、图表绘制库、网页生成器或通用修图工具。)*

## 适合什么,不适合什么

| 适合 | 不适合 |
|---|---|
| 公众号头图、博客封面、正文氛围配图 | 网站落地页、App / 组件 UI 设计 |
| 小红书 / 社媒观点卡片与多卡轮播 | Figma 原型、Logo / VI 品牌系统 |
| 论证白板、因果链推演、技术决策权衡 | 图表库式数据绘图(如 ECharts 折线/柱状图) |
| 正文解释图:六类个人关系布局 | 通用照片修图、图片格式转换 |
| 微信读书划线整理、个人阅读月报(需明确授权) | 自动静默扫描整个阅读账号正文 |
| 批量生成具备裁切/溢出自动质检的高清 PNG | 一次性聊天草图、无质检要求的涂鸦 |

## 30 秒看懂它能做什么

九种已确认的个人风格,共用纸面、字体与克制的强调色,各自表达不同的内容关系。

<img src="assets/readme-showcase.png" width="100%" alt="九种个人风格:纸上荒野封面、个人关系图、个人札记 Poster、推演札记 Whiteboard、漫游札记 Sketchnote、一句暂记 Big、长页札记 Long、比较札记 Infograph、片刻札记 Comic">

| Mode | 唯一风格 | 阅读任务 |
|---|---|---|
| cover / editorial-image | [纸上荒野](references/cover-paper-wilderness.md) | 固定系列语言,以主题意象区分每篇 |
| poster | [个人札记](references/poster-field-notes.md) | 固定 3:4,先按内容关系分组再分页 |
| article-diagram | [个人关系图](references/article-diagram-personal.md) | 六类关系布局,让结构说明内容 |
| whiteboard | [推演札记](references/whiteboard-reasoning-notes.md) | 呈现边界、转向与例外;按需要拆成总览+局部 |
| sketchnote | [漫游札记](references/sketchnote-wandering-notes.md) | 意象随阅读变化,按内容组织节奏与断行 |
| big | [一句暂记](references/mode-big.md) | 单一重音与语义停顿,完整保留长短句 |
| long | [长页札记](references/mode-long.md) | 连续正文、轻旁记、两级标题与同源引用组 |
| infograph | [比较札记](references/mode-infograph.md) | 明确比较维度与指标口径,按条件密度选择单图或总览+分组详页 |
| comic | [片刻札记](references/mode-comic.md) | 动作与镜头承担转折,文字补充背景和边界,同画面检验无字阅读 |

<sub>展示图均由仓库内的合同通过正式渲染流程生成。点击完整样张可查看细节;旧风格的迁移见<a href="references/personal-style-migration.md">迁移指南</a>。</sub>

## 支持的格式

你无需死记 mode 名称——只需用自然语言描述你的发布需求,agent 会自动选择最合适的模式。

| 发布目标 | Mode | 类型 | 画面呈现效果 | 详细文档 |
|---|---|---|---|---|
| 公众号或博客封面 | `editorial-image` | Stable | 情绪、张力与视觉隐喻(不是要点摘要列表) | [文档](references/mode-editorial-image.md) |
| 正文解释图 | `article-diagram` | Stable | 六类个人关系布局 | [文档](references/mode-article-diagram.md) |
| 社媒系列卡片 | `poster` | Stable | 适合小红书/社媒的多卡观点拆解 | [文档](references/mode-poster.md) |
| 技术决策与系统推演 | `whiteboard` | Stable | 问题、约束、可选路径与最终取舍 | [文档](references/mode-whiteboard.md) |
| 长文阅读卡 | `long` | Stable | 长页札记:连续正文、轻旁记与显式同源引文组 | [文档](references/mode-long.md) |
| 单一判断与阅读提问 | `big` | Stable | 一句暂记:语义停顿与单一阅读重音 | [文档](references/mode-big.md) |
| 高密度数据与对比 | `infograph` | Studio | 比较札记:统一维度、明确指标口径与条件,支持单图及总览+分组详页 | [文档](references/mode-infograph.md) |
| 叙事与冲突转折 | `comic` | Studio | 步骤化叙事、前后转折与故事情境 | [文档](references/mode-comic.md) |
| 个人随笔与反思 | `sketchnote` | Studio | 温暖亲切的手记风格视觉笔记 | [文档](references/mode-sketchnote.md) |

Sketchnote 自然语言请求默认使用 `variant: "wandering-notes"` 漫游札记:共享字号与间距,按来源组织意象变化、阅读节奏和中文语义断行。仍使用 Studio 完整构图;省略变体同样加载漫游札记。[规则与样例](references/sketchnote-wandering-notes.md)。

> **Stable 与 Studio 的区别:**
> - **Stable 模式:** 使用内置确定性模板,渲染快、排版稳定,适合批量生产。
> - **Studio 模式:** 支持定制 HTML/CSS 构图,适合表达复杂叙事与深度隐喻。

## 如何安装

请安装**完整功能包**(包含渲染脚本、模板、字体和质检器)。请勿只安装仓库根目录的 `SKILL.md`,否则会缺少运行时导致无法生成图片。

### Claude Code / Codex(推荐)

```bash
# Claude Code
claude plugin marketplace add KKenny0/card-skill
claude plugin install card-skill@card-skill

# Codex
codex plugin marketplace add KKenny0/card-skill
codex plugin add card-skill@card-skill
```

首次生成图片时,agent 会在已安装的 skill 目录下自动执行一次 `node scripts/setup-runtime.mjs`,安装锁定的 npm 依赖与 Playwright Chromium;后续调用直接复用该运行时。

### 其他 agent 或临时体验

完整安装(将 `-a codex` 替换为你的 agent 标识):

```bash
npx skills add KKenny0/card-skill/plugins/card-skill/skills/card-skill -a codex -g -y
cd ~/.agents/skills/card-skill
npm install
npx playwright install chromium
```

临时体验(无需常驻安装):

```bash
npx skills use KKenny0/card-skill/plugins/card-skill/skills/card-skill --skill card-skill
```

**环境要求:** Node.js 22+、npm 与 Playwright Chromium。字体随包自带,截图全程离线运行。

<details>
<summary>可选:在 Codex 桌面会话中先预览方向</summary>

在支持交互式卡片的 Codex 桌面会话中,可以明确要求先出方案再制图:

```text
先给我 3 个公众号头图方向,展示每个方向的视觉隐喻、比例、适用理由和风险;我选定后再渲染 PNG。
```

</details>

## 快速示例

无需斜杠命令,使用自然语言即可(中英文均可):

**公众号头图**
```text
把下面这篇文章做成一张公众号头图。不要复述摘要,提炼文章的核心张力,用安静的纸张质感呈现,完成后检查裁切、换行和可读性:

[粘贴文章正文或 URL]
```

**纸上荒野:唯一封面系列**

普通封面请求也直接使用纸上荒野:大标题、纸质地形与红色路标,意象随正文变化。renderer 自动加载系列布局;需要合适插画或可用生图能力,不回退到通用 motif。当前只支持已验证的 wechat-cover 横版,方版适配尚未提供。不自动添加署名。[系列工作流](references/cover-paper-wilderness.md)。

**正文解释图 / 个人关系布局**
```text
把这篇文章里值得解释的关系做成正文解释图。每张表达一个核心关系,保留必要条件,跳过纯铺垫和情绪段落。
```

**社媒系列卡片(小红书等)**
```text
把下面这段观点拆成一组社媒卡片。第一张是总判断,后面每张只讲一个支撑点,风格克制,不要营销腔。
```

**技术决策白板**
```text
把这个技术决策画成白板卡:写清问题、约束、可选路径和最终取舍,让没参与讨论的人也能看懂。
```

**微信读书划线 / 阅读月报**
```text
把我在《千脑智能》里的个人划线和想法做成一组卡片。原文不要改写,把我的想法放在对应划线下面,并标明来源。

把我这个月的微信读书数据做成阅读月报。只使用真实返回的时长、天数、读完数量和偏好;缺少的模块直接省略,不要补造洞察。
```

## 核心特性

- **标志材质(Kenny Style):** 温暖质感的纸面底色(Quiet Paper)、严谨的字系层级、克制的间距与精致的几何圆角。
- **自动质量门禁:** 截图前后自动校验文字溢出、尴尬换行、元素截断、图片失效与对比度不足。
- **纯本地与隐私保护:** 渲染与检查全部在本地通过 Playwright Chromium 完成,文章与图片绝不上传任何外部服务器。
- **Retina 高清导出:** 默认导出 2 倍高分 PNG(标准画布宽度约 2160px),满足清晰视网膜屏幕与平台发布需求。
- **调色不跑版:** 提供 `reflective`、`sharp`、`warm`、`technical` 4 种色调,只改变配色,排版间距与结构纹丝不动。
- **按内容自适应卡数:** 根据实际材料信息量自动生成 1–4 张卡片,绝不生拉硬拽填充无用废话。
- **默认无水印与署名:** 只有在输入中明确指定时才会显示作者名、Logo 或来源;未提供时界面保持纯净。

## 开源工具自适应 Showcase

card-skill 会根据输入材料的属性自适应卡片数量与结构。例如:开源工具发布会生成包含 4 项证据的完整序列,而 CLI 工具则精简为 3 张任务流卡片:

<table>
<tr>
<td width="25%"><img src="assets/open-source-tool/tool-launch-1.png" width="100%" alt="Relay Atlas 发布判断卡"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-2.png" width="100%" alt="Relay Atlas 证据卡"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-3.png" width="100%" alt="Relay Atlas 能力流程卡"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-4.png" width="100%" alt="Relay Atlas 案例卡"></td>
</tr>
</table>
<table>
<tr>
<td width="33%"><img src="assets/open-source-tool/tool-cli-1.png" width="100%" alt="Threadpack CLI 输入卡"></td>
<td width="33%"><img src="assets/open-source-tool/tool-cli-2.png" width="100%" alt="Threadpack 精确命令卡"></td>
<td width="33%"><img src="assets/open-source-tool/tool-cli-3.png" width="100%" alt="Threadpack 可检查输出卡"></td>
</tr>
</table>

<sub>以上展示数据均为虚构。详见 <a href="https://github.com/KKenny0/card-skill/tree/main/showcases/open-source-tool">可复现 showcase 目录</a>。</sub>

## 工作流程

与依赖单一 prompt 的生成式生图不同,card-skill 采用结构化、确定性的制图流程:

1. **解析内容:** 提取文本、笔记、URL 或数据中的核心论点与结构关系。
2. **匹配版式:** 匹配最适合该内容的视觉模式(如技术决策匹配白板、长文匹配编辑封面)。
3. **本地渲染:** 生成语义化 HTML/CSS,并通过 Playwright Chromium 高清渲染。
4. **质量质检:** 自动检查文本溢出、裁切问题与可读性缺陷。
5. **交付输出:** 将通过质检的高清 PNG 直接保存至系统的 `~/Downloads/` 目录。

<details>
<summary>高级用法:命令行、更新与压缩优化</summary>

### 独立命令行

你也可以直接使用命令行渲染结构化输入:

```bash
node scripts/card.js --input /path/to/input.json --output ~/Downloads/card.png
```

### 图片体积优化

默认导出的 PNG 为无损格式。如需进一步压缩体积,可使用 `pngquant`:

```bash
pngquant --quality=80-95 --force --output card.png card.png
```

### 检查更新与隐私

CLI 每天最多检查一次 GitHub Release。更新绝不会在正在制图时切换版本。如需关闭检查:

```bash
export CARD_SKILL_DISABLE_UPDATE_CHECK=1
```

如需保留检查但禁止自动升级:

```bash
export CARD_SKILL_DISABLE_AUTO_UPDATE=1
```

</details>

## FAQ

### card-skill 是什么?
它是专为 coding agent 打造的本地内容制图技能,能把文章、笔记和技术决策转化成经过质检的高清 PNG 卡片。

### 我需要会设计或手写 HTML 吗?
不需要。直接用日常文字提出需求,agent 会自动选择模式、整理数据并完成渲染。

### 支持哪些 agent?
支持 Claude Code、Codex、OpenCode、Pi 等任何支持 agent skill 的环境。Claude Code 与 Codex 推荐直接通过插件市场安装。

### 会自动添加作者署名或水印吗?
不会。只有当你在输入中明确提供作者名、Logo 或来源时才会渲染,否则对应区域保持隐藏。

### 和直接让 AI 画一张图有什么不同?
card-skill 基于确定性的 HTML/CSS 模板、文字排版规则、浏览器真实渲染与严格质检,输出的是排版工整、可直接发布的卡片,而不是随机不可控的 AI 绘画。

### 会上传我的文章或数据吗?
不会。所有渲染与质检全部在你的本地设备运行。版本检查仅访问公开的 GitHub Release。

## 完整样张

<details>
<summary>展开样张画廊(13 张)</summary>

<p><sub>样张涵盖《千脑智能》、A2A 协作与卢梭阅读札记。</sub></p>

<table>
<tr>
<td width="50%"><img src="assets/gallery/editorial-wechat-cover.png" width="100%" alt="公众号头图"><br><strong>editorial-image</strong> · 协作与内部边界</td>
<td width="50%"><img src="assets/gallery/article-formula.png" width="100%" alt="个人层级布局"><br><strong>article-diagram</strong> · 感觉、运动与参考系</td>
</tr>
<tr>
<td><img src="assets/gallery/big.png" width="100%" alt="一句话观点卡"><br><strong>big</strong> · 探索世界</td>
<td><img src="assets/gallery/poster.png" width="100%" alt="社媒卡片"><br><strong>poster</strong> · 三条线索</td>
</tr>
<tr>
<td><img src="assets/gallery/long.png" width="100%" alt="长文卡片"><br><strong>long</strong> · 卢梭:在此刻停一会儿</td>
<td><img src="assets/gallery/whiteboard.png" width="100%" alt="白板推演"><br><strong>whiteboard</strong> · A2A 协作边界</td>
</tr>
<tr>
<td><img src="assets/gallery/article-boundary-legacy.png" width="100%" alt="个人汇聚布局"><br><strong>article-diagram</strong> · 特征与位置的汇聚关系</td>
<td><img src="assets/gallery/reading-notes.png" width="100%" alt="阅读笔记"><br><strong>poster</strong> · 阅读笔记</td>
</tr>
<tr>
<td><img src="assets/gallery/infograph.png" width="100%" alt="信息图"><br><strong>infograph</strong> · 比较札记 · 三种指标口径</td>
<td><img src="assets/gallery/comic.png" width="100%" alt="漫画"><br><strong>comic</strong> · 卢梭:注意力回到手边</td>
</tr>
<tr>
<td><img src="assets/gallery/sketchnote.png" width="100%" alt="视觉手记"><br><strong>sketchnote</strong> · 卢梭:当下的安顿</td>
<td><img src="assets/gallery/reading-report.png" width="100%" alt="阅读导览"><br><strong>poster</strong> · 阅读导览</td>
</tr>
<tr><td colspan="2"><img src="assets/gallery/article-personal.png" width="720" alt="个人时间演变布局"><br><strong>article-diagram</strong> · 个人时间演变布局</td></tr>
</table>

</details>

## 微信读书整合

card-skill 可以配合腾讯官方 [WeChatReading Skill](https://github.com/Tencent/WeChatReading) 使用,将指定书籍的划线与想法整理成卡片组,或生成个人阅读月报。

它绝不会在未获指示的情况下擅自扫描账号。腾讯 Skill 负责读取与认证,card-skill 仅在本地组织数据并渲染出图。

```bash
npx skills add Tencent/WeChatReading -g
```

## 作者与社区

**card-skill** 由 [Kenny Wu (@KKenny0)](https://github.com/KKenny0) 创建并维护。

如果 card-skill 帮到了你的内容创作,欢迎在 [GitHub Issues](https://github.com/KKenny0/card-skill/issues) 分享你的作品或反馈。你也可以通过 [Support](https://kkenny0.github.io/support/) 支持本项目的持续维护。

## 致谢

card-skill 受到以下项目的启发:
- [awesome-design-md](https://github.com/VoltAgent/awesome-design-md) by VoltAgent — 品牌设计参考库
- [ljg-card](https://github.com/lijigang/ljg-skills/tree/master/skills/ljg-card) by lijigang — 内容制图与品味规则
- [Kami](https://github.com/tw93/kami) by tw93 — Quiet Paper 在纸感、墨色与节奏上的设计约束
- [The New Yorker 封面设计实践](https://www.newyorker.com/culture/video-dept/the-art-of-the-new-yorker-cover) 与 [GOV.UK 图片指引](https://guidance.publishing.service.gov.uk/formatting-content/images/) — 编辑配图的克制原则

## 开源许可

[MIT](LICENSE) © 2026 Kenny Wu
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall