Your og:image renders tofu. I made CJK-safe GitHub social cards with a coding agent

Paste a GitHub repo link into Slack or X and look at the card. For most repos it is either GitHub's auto-generated gray image or a generator template that looks like every other generator template. Add a Japanese or Korean description and it gets worse. Fallback fonts, tofu boxes, lines broken mid-word.

I built an agent skill that fixes this by having the agent design the card instead of a template filling slots. It is called Cover My Repo.

https://github.com/sjh9714/cover-my-repo

The Aug 20 update

The first version asked people to install a skill and prompt an agent. That was the step people skipped, so I wrapped the whole path in one command.

npx cover-my-repo

Run it inside a Git repository. An authenticated Codex or Cursor CLI makes editorial, poster, and adaptive options. Local Chrome renders the PNG files and opens a comparison page. There is still no image model. GitHub upload stays manual so nothing changes before you pick a card.

No image model

The interesting part is what it does not use. There is no image generation involved anywhere.

I studied the visual skills that are working right now (diagram-design, archify) and they share one mechanism. The agent writes SVG or HTML itself, and the design taste is encoded as numbers the model cannot drift from. Cover My Repo follows the same shape.

• The agent writes one self-contained 1280x640 HTML file
• A 4px grid, one accent color per card (darkened until it passes WCAG contrast), title size tiers by name length, a 110-character description budget (60 for CJK)
• A stdlib-only Python checker verifies canvas size, self-containment, contrast, and CJK line breaking. Failures go back to the agent for repair before you ever see the card

Taste as hard constraints, not prompt vibes.

CJK as a first-class citizen

Half the reason this exists.

• Japanese gets Noto Sans JP with proper line-breaking rules, so punctuation never lands at the start of a line
• Korean gets word-break: keep-all, Chinese gets Noto Sans SC
• Latin and CJK have separate character budgets, because the same pixel width carries different information density
• The checker fails a card that has Korean text without keep-all

Not "CJK supported". More like "the build fails if CJK breaks".

Five moods

editorial (warm paper and a serif wordmark), poster (a deep field mixed from your language color, your first letter as a cropped watermark), blueprint (navy grid, mono type, a plate number), gallery (a museum wall label), terminal (a command-line output card). The accent comes from your primary language, the corner arcs and plate numbers are seeded by your repo name, so no two cards match.

Every shipped example is a live view-source page.

https://sjh9714.github.io/cover-my-repo/

Usage

npx cover-my-repo

The CLI supports Codex and Cursor. Claude Code can still use the installed skill.

npx skills add sjh9714/cover-my-repo

After installing the skill, ask for this.

Make a social preview card for this repo.

PNG export uses the headless mode of the Chrome you already have, so there are no new dependencies. A bundled GitHub Action re-renders the card in CI, which also prevents the classic bug of shipping a screenshot taken before the fonts loaded.

Honest numbers

• All 12 shipped examples pass the checker in CI
• Two independent agents ran the installed skill cold during QA. Both cards passed the checker on the first try, and their friction reports produced 11 documentation fixes
• The repo's own social preview is output from the skill

MIT licensed. If you find a case where your language breaks the typography, please open an issue. It becomes a regression test in the checker.