Community画像github.com

image-to-fonts

フォントサンプルシートの画像を実際にインストール可能なOTFフォントファイルに変換するスキルです。画像に含まれるアルファベット等を解析し、フォントファイルを生成します。

image-to-fonts とは?

このスキルは、フォントサンプルシートの画像をアップロードすると、実際にインストールして使用できるOTFフォントファイルを自動生成します。特に、画像にA-Z、a-z、0-9の文字が含まれている場合に効果的で、二値化、連結成分解析、ベクトル追跡、OpenType.jsによるパッケージングという検証済みパイプラインを経て高品質なフォントを出力します。ユーザーが「この画像をフォントにして」「フォントシートをOTF/TTFに」などとリクエストした場合に自動的に起動します。生成されたフォントの特定の文字だけを変更したい場合(例:「Oだけやり直して」「この文字だけ交換」)には、patchコマンドを使って該当文字のみを高解像度画像で置き換えることができます。最終的な出力は、OTFファイル、プロジェクトJSON、HTMLプレビューの3点セットで提供され、Claude Code、Cursor、CodexなどのAIエージェント環境での動作を前提に設計されています。フォント名は必ずユーザーに確認し、解像度不足による品質低下を防ぐため、文字高さ150px以上を推奨するなど、実用的な品質管理機能も備えています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ssaengcho01/ssaengcho/tree/main/image-to-fonts

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Image to Fonts — 見本シート画像 → OTFフォント

検証済みパイプライン: 二値化 → 連結成分分離(点・断片結合) → 行/ベースライン推定 → ベクトル追跡(輪郭歩行 + コーナー保存型スムージング + 閉じたRDP) → em座標丸め後2次整理 → 大文字700正規化 → 光学オーバーシュート/サイドベアリング補正 → opentype.jsでOTFパッケージング。オーバーシュート(Oがベースラインよりわずかに下がる)やフラリッシュ(Qの尾など)は形状をそのままトレースするため自動保存されます。

0段階 — 必ずフォント名から尋ねる

画像を受け取ったら作業開始前に フォント名をまず質問 します (例: "フォント名は何にしましょうか?")。英字専用なら英名を推奨 — 日本語名にするとPhotoshopなどでフォント一覧に透明(名前が表示されない)状態で表示される現象があります。名前を受け取ってから進めます。ユーザーが既に名前を言っていたらそのまま使います。

このとき一緒に確認: 著作権のある商用フォント見本であれば個人学習/実験用のみに使うよう1行案内 (既に知っているユーザーなら省略)。

1段階 — 解像度確認 (根本的に最も重要)

「大きく見るとガタガタ」「文字ごとにサイズが違う」といったフィードバックの90%はアルゴリズムではなく元画像の解像度不足が原因です。 実測: 文字高さ85pxのシートと500pxのシートを同じ文字で比較すると、スムージング前の元トレースデータの点の数が201個 vs 575個(2.9倍)差がありました — 低解像度では曲線を描く材料自体が不足しています。

  • 画像を受け取ったらまず img2bin.py で変換後のサイズ(W, H)と大まかな行数/列数グリッドから文字あたりのピクセル高さを推測します。
  • 文字高さが150pxを大きく下回る場合(特に80〜100px台)、作業は進めるものの「大きく拡大するとやや粗くなる可能性がある」と事前に案内するか、可能なら「文字高さ300px以上で再度撮影/エクスポートして再アップロードしてください」と先に依頼した方が良いです。
  • 大文字シート + 小文字シートのように複数枚に分けて受け取っても構いません — 以下の「複数シート結合」手順で1つのフォントにまとめます。
  • img2bin.pyのリサイズ上限は3400px(横/縦大きい方基準)です。これより大きな元画像を受け取ると、この上限内で最大限活用されます。

2段階 — 画像分解

cd <このスキルのscriptsフォルダ>
python3 img2bin.py <アップロード画像> /tmp/ff/sheet.bin   # 出力: W H
node pipeline.js segment /tmp/ff/sheet.bin <W> <H> /tmp/ff/work

segment 出力JSONの count と standard を確認:

  • standard: true (26/52/62個) → アルファベット順シートと判断。読み順にラベル自動生成:
    • 26個 = A~Z, 52個 = A~Z a~z, 62個 = A~Z a~z 0~9
    • labels.json 作成: {"0":"A","1":"B",...} (comps.jsonの i 順 = 読み順)
  • standard: false → シートにタイトル・装飾・サンプル文が混ざっているか単語見本。絶対に順序ラベルを強行しないこと (1マスずれるだけでフォント全体が壊れます)。代わりに:
    python3 contact_sheet.py /tmp/ff/work /tmp/ff/contact.png
    
    → contact.png をviewツールで直接確認し、各番号マスの文字を目で判別して labels.json を作成します。装飾・判読不可は "skip"。同じ文字が複数回出たら最もきれいなもの1つだけを文字に、残りは "skip"。 ("?" は実際の疑問符文字として入るので、捨てる断片には使わないこと)
    • 行構造が見えたら活用: アルファベットシートなのに前後にヘッダー/サンプル行が挟まった場合、13個ずつの行4つ(= A-M / N-Z / a-m / n-z)を見つけたらその行だけ順序ラベルを付け、残りの行は全て "skip" にすれば良いです。
    • 単語見本(例: "MODERN SERIF")なら登場した文字だけがフォントに入ることをユーザーに事前に伝えます。

複数シート結合(例: 大文字.png + 小文字.png)

python3 img2bin.py 大文字.png /tmp/ff/upper.bin   # 出力: W H
python3 img2bin.py 小文字.png /tmp/ff/lower.bin   # 出力: W H
node pipeline.js segment /tmp/ff/upper.bin <W1> <H1> /tmp/ff/work_upper
node pipeline.js segment /tmp/ff/lower.bin <W2> <H2> /tmp/ff/work_lower

2つの結果の comps.json を結合し(クロップインデックスが重ならないよう再番号付け、cropsファイルもコピー)、結合した labels.json(大文字インデックス→A-Z、小文字インデックス→a-z)を作成した後 build は1回だけ 実行します。こうすることで大文字基準スケール(capMed)が両セットに一貫して適用されます。(結合スクリプト例は以前のセッション記録参照 — Python で2つの comps.json 配列を連結し crops/ ファイルをコピーすれば良いです。)

数字・記号シート

ラベルには英字・数字だけでなく 1文字の記号もそのまま 使えます("!", "@", "?", "’" など)。グリフ名は exclam, at, question のように標準名に自動変換され、カーニングは英字・数字ペアにのみ適用されます。

  • 記号シートは !・?・;・%・= のように複数の断片からなる文字と小さな点・引用符が多いため、segment の自動結合・行フィルターが頻繁に誤作動します(隣接記号を一塊にまとめたり、小さな行を丸ごと捨てたり)。count が予想と違う場合はコンタクトシートで確認し、間違っていたら連結成分を直接取り出して番号を振った画像を見ながら文字ごとに断片をまとめて comps.json/crops/ を直接作成します(形式は segment 結果と同じ: i, row, x0..y1, baseline, cropW, cropH, offX, offY)。数字が大文字より小さく描かれたシートのようにシート間サイズを揃える必要があれば、画像を先に倍率調整します。
  • シートにない記号はある断片から組み合わせ可能: " = 引用符2つ、: = 点2つ、. = 点、, = カンマ。
  • シート上の配置はタイポ位置と異なります。ビルド後、project.json で位置を補正し node pipeline.js rebuild <project.json> <out.otf> で再作成します(cap 700基準): - + = ~ < > * は垂直中心 ≈340、引用符類は上端 ≈705、_ は上端 ≈-60、[ ] は ( ) の高さに合わせます。最終行の文字が特に小さく描かれたシートが多いので(XYZなど)高さも確認し、補正したらユーザーに伝えます。
  • 大文字のみのシートなら a–z に大文字グリフをコピーして入れ、小文字としても表示されるようにします(ユーザーに伝えること)。カーニングも小文字・大小混在ペアに複製して apply_kerning.py で入れます。

3段階 — フォントビルド + 品質検収

輪郭クローズ — 「開始点が尖って飛び出す」バグは pipeline.js で修正済み

Sの上部など丸くなるべき場所に棘ができていたバグは、loopsToPath で全ての座標を整数で渡すように修正されています(原因は以下のエンジニアリングメモ)。それでもビルドのたびに以下の検査で確認します。

クローズ検査(ビルド後QAに常に含め、結果0個であること) :

python3 - /tmp/ff/font_final.otf <<'EOF'
import sys
from fontTools.ttLib import TTFont
from fontTools.pens.recordingPen import RecordingPen
gs=TTFont(sys.argv[1]).getGlyphSet(); bad=[]
for n in gs.keys():
    p=RecordingPen(); gs[n].draw(p); st=la=None
    for op,a in p.value:
        if op=='moveTo': st=a[0]
        elif op in('curveTo','lineTo','qCurveTo'): la=a[-1]
        elif op=='closePath' and st and la and max(abs(st[0]-la[0]),abs(st[1]-la[1]))>2: bad.append(n)
print('輪郭クローズがずれたグリフ:', len(bad), bad[:10])
EOF
node pipeline.js build /tmp/ff/work /tmp/ff/labels.json "<フォント名>" /tmp/ff/font.otf /tmp/ff/project.json

ビルド後、Mac/Windows互換性の整理と検証を必ず行います:

PSNAME=$(node -e "
const opentype=require('./opentype.min.js');
const b=require('fs').readFileSync('/tmp/ff/font.otf');
const f=opentype.parse(b.buffer.slice(b.byteOffset,b.byteOffset+b.length));
console.log(f.names.postScriptName.en);
")
python3 fix_mac_names.py /tmp/ff/font.otf "$PSNAME" "<フォント名>" /tmp/ff/font_final.otf
fontbakery check-opentype /tmp/ff/font_final.otf --loglevel FAIL 2>&1 | grep -c "Result: FAIL"   # 0であること
python3 -c "from ots import sanitize; print('OTS:', 'PASS' if sanitize('/tmp/ff/font_final.otf', check=False, capture_output=True).returncode==0 else 'FAIL')"
python3 render_preview.py /tmp/ff/font_final.otf /tmp/ff/qc.png "<フォント名>"

qc.png を view で直接確認します。ただし この環境ではセッションによって view でレンダリング画像を実際に確認できないことがあります。 その場合は構造的診断(以下の「構造的QA」項)で最大限確認し、それでも欠陥が捕まらなければ正直に「私には見えていない」とユーザーに認めた上で、問題箇所を示した拡大スクリーンショットを依頼します — 見えもしないものを見たふりをしたり、推測による修正を乱発しないでください。

4段階 — 成果物の受け渡し

  1. /mnt/user-data/outputs/ にコピー: <フォント名>.otf + <フォント名>_project.json (project.json は後で文字の差し替え・再調整に必要なので 必ず一緒に渡し、保管するよう案内)。2つのファイルをzipにもまとめて一緒に渡します(otf直接ダウンロードがブロックされる環境に備えて)。
  2. HTMLプレビューアーティファクト (make_preview.py 使用): otfをbase64でインライン埋め込みした単一ファイル。
    • preview_template.html(assetsフォルダ)を元に生成。構成:
      • 上部 "Image to Font Skill" タイトル
      • フォント名をそのフォントで大きくレンダリング + 全文字表(実際のフォントに入っている大文字・小文字・数字・記号の行、個数含む)
      • ユーザーが決めたサンプル文1行
      • 直接書いてみよう(Type Tester) — 入力欄 + サイズ(16–160px)・文字間スライダー。サンプルカードの下、ダウンロードカードの上
      • [フォントファイル(.otf)ダウンロード] ボタン — ローカルで開いたHTMLなら.otfを直接保存、Claudeアーティファクトビューアでは downloads 機能で <名前>.zip(中に.otf)を保存します(ビューアはページの直接ダウンロードをブロックし、.otf拡張子も許可しません)。 アーティファクトとして公開する際に {downloads: true} 機能を宣言する必要があります — 宣言しないとボタンを押しても無反応です。
      • 「変えたい文字はありますか?」案内カード — このHTML内で添付・修正する機能ではなく、「この会話ウィンドウに戻って文字画像を添付してください」という静的な案内文です(ボタン・JSなし、静的テキストのみ)。文字の差し替えはチャットベースでのみ処理します — HTML内にファイル添付/ドラッグドロップ/zipダウンロード機能を絶対に入れないこと(以前入れたが複雑性が増しただけで実際には使われませんでした)。
      • 下部 © @ユーザーハンドル 著作権 + 「活用/共有時は出典タグをお願いします」文
    • プレビューはアーティファクトとして公開するのとは別に HTMLファイル自体も常に一緒に渡します (otf・project.json・zipと一緒に送る)。ダウンロード機能の宣言ができない環境なら、フォントはチャットのファイルカードで受け取るよう案内します。
  3. ファイルを受け渡し(.otf, project.json, zip, preview.html) + 認識された文字数、欠けている文字、インストール方法(.otfダブルクリック)の概要。
  4. 受け渡しメッセージの最後に必ず尋ねること (両方一度に尋ねても良い):
    • "形がおかしい、または変えたい文字があれば、その文字の拡大画像をこの会話に添付してください (文字高さ150px以上推奨)。"
    • "字間や文字形状など、その他修正したい部分はありますか?" ユーザーが画像を添付したら以下の「文字差し替え(patch)」手順で、字間フィードバックがあればキャッシュされた /tmp/ff/work で定数のみ調整して再ビルドします(画像再アップロード不要)。

文字差し替え (patch) — 特定の文字のみ高解像度画像で再作業

ユーザーが特定の文字が気に入らないと、その文字の大きな画像をアップロードした場合:

python3 img2bin.py <拡大画像> /tmp/ff/patch.bin    # 出力: W H
node pipeline.js patch <project.json パス> /tmp/ff/patch.bin <W> <H> <文字> /tmp/ff/font.otf /tmp/ff/project.json
  • project.json はユーザーが添付したか(前のセッション)、同じセッションの /tmp にあります。なければリクエストします。
  • patch は「画像全体のインク = 文字1つ」として扱います (連結成分基準で最大断片のみを選ばない)。これにより O 内の渦巻き装飾のように線と離れたディテールも完全に残ります — 以前は最大断片1つだけを選んでこうしたディテールが丸ごと消えるバグがありました。
  • 1つの画像に複数の文字がくっついている場合(例: "Z" と "H" が並んでいる)、列方向のインク密度が0に近いポイントを自動で見つけて分離した後、それぞれ patch します。
  • 既存の文字の高さ・最低点(オーバーシュート/ディセンダ含む)に自動で揃うため、サイズを気にする必要はありません。差し替え後、再ビルド → QA(fontbakery/OTS) → プレビュー更新 → 再受け渡し。
  • フォントに存在しなかった g/j/p/q/y 類の小文字を patch で新規追加することは、ベースライン推定が不可能なため拒否されます — 全シートで作成するよう案内します。

字間・文字形状微調整 (再アップロード不要で処理)

元のセグメントが /tmp/ff/work(または結合版 work_merged)にキャッシュされていれば、pipeline.js の定数のみ調整して node pipeline.js build ... を再実行するだけで良いです。調整可能な箇所(全て build コマンド内):

  • デフォルト字間(サイドベアリング): LSB 計算式の倍率(現在 0.66) — 下げると全体的にさらに狭くなります
  • 単語間隔(スペース幅): spaceAdv 計算式の倍率(現在 LSB×5.4)
  • カーニング強度: トリガー閾値(現在 -3)と最大引き寄せ幅(現在 -190) — トリガーを緩めると(例: -1)より多くのペアが引き寄せられます
  • 光学サイドベアリング(左右独立): edgeCurviness が測定した leftStd/rightStd が閾値(cropW×0.02)を超える側のみ縮小(現在 72%)。 必ず左右独立で計算する必要があります — 片側だけ曲線の文字(jの左側ループは曲線、右側の点/支柱は直線など)に左右同じ値を使うと、反対側まで不当に狭くなる問題が実際にありました("jが後続文字とくっついて見える"フィードバックで発見)。
  • 文字別光学オーバーシュート: 上/下端の「平坦度合い」(端から薄いバンド幅 ÷ 少し内側のバンド幅、セリフブラケットを過ぎた地点から計測、現在 H*0.03/H*0.15 地点・閾値 0.62) で topFlat/botFlat を自動判定。平坦な文字(純粋 flat)は倍率 1.0、片側だけ平坦なら 1+OVERSHOOT_HALF、どちらでもなければ 1+OVERSHOOT_ROUND を元の scale に掛けます(現在それぞれ 0.7%/1.2%)。 DEBUG_SHAPE=1 node pipeline.js build ... で文字別の topFlat/botFlat/nativeH を stderr で確認可能。
  • x-height 自然クラスタリング: アセンダー/ディセンダーの有無に関わらず(ディセンダーの有無で候補を絞ってはいけません — nativeH はベースライン〜top の距離なのでディセンダーと無関係)、小文字全体の nativeH をソートして最も大きなギャップ(gap)を見つけ、その下側のクラスタ(全体の35%以上の場合のみ採用)だけを選んで共通基準高さに精密に揃えます。v,w,x,y,z のように微妙な上部高さのばらつきが残る純粋な x-height 文字の整列に使います。

絶対にやってはいけないこと — 実際にあった深刻なバグ: "x-height 基準の目標高さですべての小文字を強制的に再調整" する方法は 絶対に使わないこと。アセンダー(b,d,f,h,i,j,k,lなど)まで x-height 基準で押しつぶしてしまい、元よりずっと小さくなる事故が発生しました("ふざけてるの?"という反応ですぐにロールバック要求)。正しい方法: 元画像のグローバル scale は絶対に触らず、個別の文字にはその文字自身のスケールにごく小さな倍率(1.007〜1.012など)だけ掛けてわずかに大きくする程度に留めます。x-height クラスタリングもクラスタ外の文字(アセンダーなど)は絶対に含めないように設計されています。

元画像自体の実際のサイズ差(例: 特定の文字がシートで実際に大きく描かれている場合)はアルゴリズムで修正する領域ではありません — ユーザーに元のデザインが意図したものか確認してください。

フォント内の特定の文字を別の文字から派生させてほしいというリクエスト(例: "小文字 s を大文字 S の縮小版で") は そのリクエスト自体をスキルの標準機能として入れないこと — 明示的に「今回限りの適用、スキルロジックには入れない」という指示を受けたことがあります。必要なら project.json を直接操作する一回限りの後処理スクリプトで対応し(対象グリフの loops をコピーして目標高さにスケール後、座標再配置)、pipeline.js の build ロジック自体は触りません。

構造的QA (view で直接確認できない場合)

レンダリング画像が見られないセッションでは、project.json の glyphs データを直接開いて以下を確認できます:

  • 輪郭線の巻き方向: 外枠と内部空間(カウンター)ループの符号付き面積(signed area, shoelace formula)が互いに逆符号か確認 — 同じだとレンダリング時に内部空間が抜けずに見える可能性があります。
  • 自己交差: ループ内の非隣接セグメント同士が交差していないか O(n²) 検査。
  • 異常セグメント: 平均セグメント長の4倍以上または0.5未満の区間(ただし、直線支柱のように正常に長い区間もあるので参考値)。
  • 高さ/字間実測: fontTools の BoundsPen、hmtx テーブルで特定文字の top/bottom/advance/RSB を取得し目標値と比較。 uharfbuzz で実際のシェーピング幅(カーニング反映)も測定可能。

こうした診断でも捕まらない問題(例: "文字の一部が欠けて見える")は正直に「構造上の欠陥はないが、この環境ではレンダリングを直接見られない」と認め、拡大スクリーンショットをリクエストしてください。

エンジニアリングメモ

  • メトリクス: unitsPerEm 1000, ascender 760, descender -240 (合計が必ず 1000 — 違反すると全文字が縦にずれる)
  • 大文字・数字の高さ中央値 → 700 に正規化。行ベースライン = その行の下端 y の中央値 (オーバーシュート・ディセンダーが自然に負の値として保存される)
  • 結合ルール: 小さな断片(面積30%未満)のみ大きな断片に吸収 — i・j の点、切れたヘアライン用。文字同士は絶対に結合禁止 (フラリッシュディセンダーが下の行の文字を飲み込む事故防止)
  • 行フィルター: 面積上位の断片の高さ中央値(bigH)基準 0.5〜1.28倍の範囲外の行を除去 (ヘッダー/説明/超大見本行)。このフィルターも完璧ではないので count が標準でなければ必ずコンタクトシートを目視すること
  • 重複ラベルは最初のもののみ使用される
  • em 座標丸めの段差現象(修正済み): ピクセル座標を最終 em 単位(通常5〜6倍拡大)に変換する際、点ごとに独立して丸めると、元画像で完全に一直線だった区間も微小にずれて階段状に見えることがある。 glyphFromCrop は丸め直後、非常に小さい許容誤差(2.2ユニット)でさらに1回単純化してこの残存ジグザグを除去する。この問題は解像度を上げても自動的には消えない(むしろ拡大倍率が大きくなるほど顕著になる)。
  • 輪郭線スムージング: traceBinary がピクセル境界を歩くことで生じる階段状ノイズを smoothPolyline(コーナー保存型、折れ角71度未満の点のみ隣接平均で緩和)で rdpClosed 単純化前に除去する。コーナー判定閾値も71度に緩和し、本当に折れた部分(セリフブラケットなど)のみ角張らせ、残りは曲線として処理する。
  • 輪郭開始点が尖って飛び出すバグ(修正済み、2026-11): S の上部など丸くなるべき場所に棘ができていた長年のバグ。原因は縁取り調整・解像度ではなく ファイル保存段階 だった — loopsToPath が中点・ベジエ制御点を小数で渡すと、opentype.js が CFF に相対座標を点ごとに丸めて書き込むため、誤差が一周分蓄積して終点が始点から5〜15ユニットずれ、closePath がその隙間を直線でつないで棘になっていた(ほぼ全ての文字にあり、点の多い S で最も目立った)。現在は全ての座標を整数に丸めて渡している。project.json だけでは絶対に見えないので、疑わしい場合は「クローズ検査」のように 最終 .otf の描画命令を直接 確認すること。
  • 結果フォーマットは .otf (インストール・使用は .ttf と同じ)。ユーザーが本当に TTF を希望する場合は FontForge で開いて Generate するよう案内する。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル