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
<p align="center"><img src="assets/logo.png" alt="card-skill logo" width="112"></p>

Long now uses Long-page Notes as its default and sole style: continuous prose, light marginal notes, two heading levels, and explicitly declared same-source quotation groups. Original text and attribution remain intact; adjacency alone never merges quotations.

Confirmed modes now have one supported personal style each. Covers use Paper Wilderness only; Poster retains all content blocks under field-notes. Old style contracts require migration; see [migration guide](references/personal-style-migration.md).

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

New article-diagram requests default to six personal, browser-measured relationship layouts. See [contracts, fit limits and splitting rules](references/article-diagram-personal.md). Old formula and family contracts require replanning.

<p align="center"><strong>Turn articles, ideas, and arguments into publish-ready visual cards.</strong></p>

<p align="center">
  <a href="README.zh-CN.md">中文文档</a> ·
  <a href="#what-it-is">What it is</a> ·
  <a href="#how-to-install">Install</a> ·
  <a href="#quick-examples">Examples</a> ·
  <a href="#supported-formats">Formats</a> ·
  <a href="#faq">FAQ</a> ·
  <a href="#full-gallery">Gallery</a>
</p>

## What it is

Comic now uses **Moment Notes**: scene-led actions and camera distance, clean paper, and a same-art wordless review. Optional bounded `comic_art` embeds conceptual artwork through the normal checked/reviewed pipeline; free SVG composition remains available.

**card-skill** turns articles, notes, arguments, and technical decisions into publish-ready visual cards for coding agents (Claude Code, Codex, OpenCode, Pi, etc.).

Unlike generic AI image generators that produce unpredictable illustrations, card-skill focuses on **information hierarchy, readable typography, and structured reasoning**. Everything renders locally via headless browser and undergoes automatic layout checks before export in a signature tactile paper aesthetic (**Kenny Style**).

### Core uses
- **Editorial covers:** Article headers, blog covers, and mood visuals with metaphors.
- **In-article diagrams & whiteboards:** Compress complex arguments, causal chains, and system trade-offs into structured visual cards.
- **Social card series:** Break down opinions into multi-card carousels or high-density reading cards.

*(It is not a UI builder, chart plotter, website generator, or photo editor.)*

## Good fit / poor fit

| Good fit | Poor fit |
|---|---|
| WeChat covers, blog headers, article atmosphere images | Websites, landing pages, app/component UI |
| Xiaohongshu / social opinion cards and carousels | Figma prototypes, logo / brand identity systems |
| Argument whiteboards, system relations, technical decisions | Chart-library plotting (ECharts and similar) |
| In-article diagrams: six source-grounded relationship layouts | Generic photo editing or file conversion |
| WeChat Reading highlights and monthly reports (when requested) | Silently scanning an entire reading account |
| Consistent batch PNGs with automated crop/overflow quality checks | One-off chat illustrations with no quality gate |

## See it in 30 seconds

Nine confirmed personal styles share paper, typography, and restrained accents. Each gives a different content relationship a readable form.

<img src="assets/readme-showcase.png" width="100%" alt="Nine personal styles: Paper Wilderness cover, relation diagram, field-note poster, reasoning whiteboard, wandering sketchnote, Big reading notes, Long-page notes, comparison infographs, and Moment Notes comics">

| Mode | Sole style | Reading task |
|---|---|---|
| cover / editorial-image | [Paper Wilderness](references/cover-paper-wilderness.md) | Recognize the series; distinguish topics through imagery |
| poster | [Personal field notes](references/poster-field-notes.md) | Group meaning before pagination on fixed 3:4 pages |
| article-diagram | [Personal relations](references/article-diagram-personal.md) | Explain content through six relationship layouts |
| whiteboard | [Reasoning notes](references/whiteboard-reasoning-notes.md) | Follow boundaries, turns, and exceptions; split into overview and details when needed |
| sketchnote | [Wandering notes](references/sketchnote-wandering-notes.md) | Let imagery evolve with the reading rhythm |
| big | [A Momentary Note](references/mode-big.md) | One reading accent and semantic pauses, preserving the complete phrase |
| long | [Long-page Notes](references/mode-long.md) | Continuous prose, marginal notes, heading levels and explicit quotation groups |
| infograph | [Comparison notes](references/mode-infograph.md) | Compare dimensions and metric scopes; keep conditions visible across single or grouped pages |
| comic | [Moment notes](references/mode-comic.md) | Actions and camera distance carry the turn; words retain context and boundaries |

<sub>All showcase images are rebuilt from repository contracts through the production renderer. Open the full samples for detail. See the <a href="references/personal-style-migration.md">migration guide</a> for retired styles.</sub>

## Supported formats

You don't need to memorize mode names—describe what you want to publish in natural language, and the agent picks the best mode.

| Publishing goal | Mode | Tier | What it produces | Reference |
|---|---|---|---|---|
| WeChat or blog cover | `editorial-image` | Stable | Mood, tension, and metaphor (not a text summary) | [Docs](references/mode-editorial-image.md) |
| In-article explanation | `article-diagram` | Stable | Six personal relationship layouts | [Docs](references/mode-article-diagram.md) |
| Social card series | `poster` | Stable | Multi-card breakdown for social media (Xiaohongshu, X) | [Docs](references/mode-poster.md) |
| Technical decisions & systems | `whiteboard` | Stable | Problems, constraints, decision paths, and trade-offs | [Docs](references/mode-whiteboard.md) |
| Long reading cards | `long` | Stable | Long-page notes with continuous prose, light annotations and explicit quotation groups | [Docs](references/mode-long.md) |
| Single claims & reading questions | `big` | Stable | A momentary note with semantic pauses and one reading accent | [Docs](references/mode-big.md) |
| Dense data & comparison | `infograph` | Studio | Comparison notes: aligned dimensions, metric scopes, and conditional conclusions; single or grouped pages | [Docs](references/mode-infograph.md) |
| Narrative & conflict | `comic` | Studio | Step-by-step conflict, turn, or before/after stories | [Docs](references/mode-comic.md) |
| Personal reflections | `sketchnote` | Studio | Warm, notebook-style visual notes | [Docs](references/mode-sketchnote.md) |

New sketchnote requests default to `variant: "wandering-notes"`: shared typography and spacing with source-driven metaphor changes, reading rhythm, and semantic Chinese line breaks. It remains a Studio composition; omitted variants also load wandering notes. [Rules and examples](references/sketchnote-wandering-notes.md).

> **Stable vs. Studio:**
> - **Stable modes** use deterministic built-in templates—fast, consistent, and ideal for batch generation.
> - **Studio modes** support bespoke HTML/CSS layouts for complex narratives and custom visual metaphors.

## How to install

Install the **complete package** (includes render scripts, templates, fonts, and checkers). Do not install only the repository-root `SKILL.md`, as it lacks the runtime.

### Claude Code / Codex (recommended)

```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
```

On first render, the agent runs `node scripts/setup-runtime.mjs` once inside the skill directory to install locked npm dependencies and Playwright Chromium. Subsequent runs reuse this runtime.

### Other agents or one-off use

Install the skill package (replace `-a codex` with your agent ID):

```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
```

Run once without permanent install:

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

**Requirements:** Node.js 22+, npm, and Playwright Chromium. Fonts are bundled; rendering runs offline.

<details>
<summary>Optional: preview directions in Codex desktop</summary>

In Codex desktop sessions supporting interactive cards, you can request direction options before rendering:

```text
Give me 3 WeChat cover directions first. Show each direction's visual metaphor, aspect ratio, why it fits, and risks on cards. Render the PNG only after I pick one.
```

</details>

## Quick examples

No slash commands required. Prompts work in plain English or Chinese:

**WeChat / editorial cover**
```text
Turn the article below into a WeChat cover image. Do not restate it as a summary. Extract the core tension, render it with a quiet paper feel, and check crop, line breaks, and readability before delivery:

[paste article or URL]
```

**Paper Wilderness — the only cover series**

Every cover request uses large headlines, paper terrain and the red trail marker, with imagery based on the article. The renderer loads the shared layout. Suitable artwork or an available image-generation tool is required; no generic motif fallback. Only the verified wechat-cover ratio is supported for now. Square adaptation is not yet available. Branding is opt-in. [Series workflow](references/cover-paper-wilderness.md).

**In-article diagram / personal relation layouts**
```text
Turn the useful relationships in this article into in-article explanation diagrams. Express one core relationship per image and keep necessary conditions visible. Skip pure setup and mood sections.
```

**Social card series**
```text
Split the argument below into a social card series. Card 1 is the main judgment; each later card covers one supporting point. Keep the tone restrained—no marketing voice.
```

**Technical whiteboard**
```text
Draw this technical decision as a whiteboard card: state the problem, constraints, option paths, and final trade-off so someone who missed the discussion can follow it.
```

**WeChat Reading highlights / monthly report**
```text
Turn my personal highlights and thoughts from *A Thousand Brains* into a card set. Keep source quotes unedited. Place my thoughts under the matching highlight; label the source.

Turn this month's WeChat Reading stats into a monthly reading report. Use only real duration, day counts, finished books, and preferences. Omit missing modules. Do not invent insights.
```

## Key features

- **Tactile aesthetic (Kenny Style):** Warm paper texture ("Quiet Paper"), disciplined typography, balanced spacing, and subtle geometry.
- **Automated quality checks:** Built-in verification catches text overflow, awkward line breaks, broken images, and poor contrast before exporting.
- **100% local & private:** Rendering and checks run entirely on your machine via Playwright Chromium. Your text and images are never uploaded.
- **Retina-ready export:** Outputs crisp @2x PNGs (e.g., ~2160px wide for standard canvases) ready for publishing.
- **Mood tones without layout drift:** Switch color mood (`reflective`, `sharp`, `warm`, `technical`) without breaking typography or spacing.
- **Content-adaptive layout:** Adapts card counts (1–4 cards) based on actual content density rather than forcing arbitrary filler.
- **Zero watermarks:** Names, logos, and sources appear only when explicitly provided; otherwise layouts stay clean and unbranded.

## Adaptive open-source showcase

card-skill automatically adapts card counts and structure to the material. For example, a product launch generates a 4-card evidence sequence, while a CLI tool generates a 3-step task flow:

<table>
<tr>
<td width="25%"><img src="assets/open-source-tool/tool-launch-1.png" width="100%" alt="Relay Atlas launch judgment card"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-2.png" width="100%" alt="Relay Atlas evidence card"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-3.png" width="100%" alt="Relay Atlas capability process card"></td>
<td width="25%"><img src="assets/open-source-tool/tool-launch-4.png" width="100%" alt="Relay Atlas case card"></td>
</tr>
</table>
<table>
<tr>
<td width="33%"><img src="assets/open-source-tool/tool-cli-1.png" width="100%" alt="Threadpack CLI input card"></td>
<td width="33%"><img src="assets/open-source-tool/tool-cli-2.png" width="100%" alt="Threadpack exact command card"></td>
<td width="33%"><img src="assets/open-source-tool/tool-cli-3.png" width="100%" alt="Threadpack inspectable output card"></td>
</tr>
</table>

<sub>All project data above is fictional and repository-owned. See the <a href="https://github.com/KKenny0/card-skill/tree/main/showcases/open-source-tool">reproducible showcase</a>.</sub>

## How it works

Unlike tools that rely on a single generative prompt, card-skill runs a deterministic pipeline from text to PNG:

1. **Parse content:** Analyzes raw text, notes, URLs, or data to extract core claims and relationships.
2. **Pick layout:** Selects the best visual mode (e.g., whiteboard for decisions, editorial cover for articles).
3. **Render locally:** Generates semantic markup and renders high-res PNGs via Playwright Chromium.
4. **Quality gate:** Inspects the output for overflow, bad wrapping, and readability issues.
5. **Deliver:** Saves the verified PNG directly to your `~/Downloads/` folder.

<details>
<summary>Advanced: CLI commands, updates, and optimization</summary>

### Standalone CLI

You can run the structured CLI directly:

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

### File size optimization

Default PNG exports are lossless. For smaller files, compress with `pngquant`:

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

### Updates and privacy

The CLI checks GitHub for releases at most once daily. Updates are never performed mid-render. To disable update checks:

```bash
export CARD_SKILL_DISABLE_UPDATE_CHECK=1
```

To allow checks but disable auto-updates:

```bash
export CARD_SKILL_DISABLE_AUTO_UPDATE=1
```

</details>

## FAQ

### What is card-skill?
It is a local content-to-image skill for coding agents. It turns articles, notes, and technical decisions into quality-checked PNG cards.

### Do I need design skills or HTML knowledge?
No. Describe what you want in plain text; the agent selects the mode, formats the data, and renders the image.

### Which agents are supported?
Claude Code, Codex, OpenCode, Pi, and any environment supporting agent skills. Claude Code and Codex should use the plugin marketplace.

### Does it watermark or add author names?
No. Author name, avatar, and sources are only rendered if explicitly provided in your input.

### How is this different from asking an AI to draw an image?
card-skill uses deterministic HTML/CSS templates, typography rules, Playwright capture, and strict visual checks. The result is a crisp, reproducible, publish-ready card rather than a random AI image.

### Will it upload my articles or data?
No. All rendering and visual checks run locally on your machine. Version checks only query GitHub Releases.

## Full gallery

<details>
<summary>Expand gallery (13 samples)</summary>

<p><sub>Samples cover *A Thousand Brains*, A2A collaboration, and a Rousseau reading reflection.</sub></p>

<table>
<tr>
<td width="50%"><img src="assets/gallery/editorial-wechat-cover.png" width="100%" alt="WeChat cover"><br><strong>editorial-image</strong> · Collaboration across internal boundaries</td>
<td width="50%"><img src="assets/gallery/article-formula.png" width="100%" alt="Personal hierarchy"><br><strong>article-diagram</strong> · Sensation, movement, reference frames</td>
</tr>
<tr>
<td><img src="assets/gallery/big.png" width="100%" alt="One-line card"><br><strong>big</strong> · Explore the world</td>
<td><img src="assets/gallery/poster.png" width="100%" alt="Social cards"><br><strong>poster</strong> · Three threads</td>
</tr>
<tr>
<td><img src="assets/gallery/long.png" width="100%" alt="Long card"><br><strong>long</strong> · Rousseau: pausing in the present</td>
<td><img src="assets/gallery/whiteboard.png" width="100%" alt="Whiteboard"><br><strong>whiteboard</strong> · A2A collaboration boundaries</td>
</tr>
<tr>
<td><img src="assets/gallery/article-boundary-legacy.png" width="100%" alt="Personal convergence"><br><strong>article-diagram</strong> · Reference frame model</td>
<td><img src="assets/gallery/reading-notes.png" width="100%" alt="Reading notes"><br><strong>poster</strong> · Reading notes</td>
</tr>
<tr>
<td><img src="assets/gallery/infograph.png" width="100%" alt="Infograph"><br><strong>infograph</strong> · Comparison notes · three metric scopes</td>
<td><img src="assets/gallery/comic.png" width="100%" alt="Comic"><br><strong>comic</strong> · Rousseau: attention returns to the water</td>
</tr>
<tr>
<td><img src="assets/gallery/sketchnote.png" width="100%" alt="Sketchnote"><br><strong>sketchnote</strong> · Finding a moment of rest / Rousseau</td>
<td><img src="assets/gallery/reading-report.png" width="100%" alt="Reading guide"><br><strong>poster</strong> · Reading guide</td>
</tr>
<tr><td colspan="2"><img src="assets/gallery/article-personal.png" width="720" alt="Personal timeline"><br><strong>article-diagram</strong> · Personal timeline</td></tr>
</table>

</details>

## WeChat Reading integration

card-skill pairs with Tencent's official [WeChatReading Skill](https://github.com/Tencent/WeChatReading) to turn personal highlights from a specific book into a card set, or reading statistics into reports.

It never scans arbitrary books or accounts without instruction. The Tencent skill handles auth; card-skill only formats and renders the data locally.

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

## Author & community

**card-skill** is created and maintained by [Kenny Wu (@KKenny0)](https://github.com/KKenny0).

If card-skill helped you publish something, share your results or feedback in [GitHub Issues](https://github.com/KKenny0/card-skill/issues). You can also support maintenance via [Support](https://kkenny0.github.io/support/).

## Credits

card-skill is inspired by:
- [awesome-design-md](https://github.com/VoltAgent/awesome-design-md) by VoltAgent — brand design reference library
- [ljg-card](https://github.com/lijigang/ljg-skills/tree/master/skills/ljg-card) by lijigang — content-to-image practice and taste rules
- [Kami](https://github.com/tw93/kami) by tw93 — Quiet Paper constraints on paper, ink, and rhythm
- [The New Yorker cover practice](https://www.newyorker.com/culture/video-dept/the-art-of-the-new-yorker-cover) & [GOV.UK image guidance](https://guidance.publishing.service.gov.uk/formatting-content/images/) — editorial purpose and restraint

## License

[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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall