Community画像github.com

paper-brush

紙を切り抜いたようなフラットなイラスト(ポートレート、アバター、キャラクター、シーン、アイコン)を、画像モデルを使わずに決定論的なコードで描画します。一貫したペーパーカットルックのセットや、統一された絵柄の画像を追加するために使用します。

paper-brush とは?

このスキルは、Pythonコードを使って「ペーパーカット(紙工芸)」風のフラットなイラストを決定論的にレンダリングするエンジンです。同じ描画ファイルからは常に同じピクセルが出力されるため、複数のイラストからなるセット全体で一貫性を保つことができ、形状の微調整はコード上の数値を編集するだけで行えます。 対応プラットフォームはClaude Code、Cursor、Codexなど、コード実行が可能なAIエージェント環境全般です。レンダリングエンジンは `references/engine.md` に同梱されており、一度プロジェクトにコピーするだけで使えます。numpy と opencv-python が必要です。 ワークフローは「スタイルガイドに従って形状をコードで定義 → グリッド上で座標指定 → レンダリング → 参考画像と比較して調整」という流れ。既存のセットに新しい絵を追加する場合は、まずルールを文書化し、リファレンスを再現してキャリブレーションした後、既存の部品(目の形など)を流用しながら新しい絵を描き、サムネイルレベルで見分けがつかなくなるまでイテレーションします。 顔のパーツは「ヘッド単位」と呼ばれる正規化された座標系で定義でき、一度作ったパーツを複数の顔で使い回せるため、セット全体が同じ手で描かれたように見えます。また、`mirror` フラグで描き直さずに顔の向きを反転できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/paper-brush/tree/HEAD/skills/paper-brush

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

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

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

ドキュメント

Paper brush(紙工芸ブラシ)

フラットなペーパーカットイラストのための決定論的レンダラー:すべての絵は、ペンツールで切り抜いたパス上の色紙の形状を、短い積み重ねで表現します。同じ描画ファイルを入力すれば同じピクセルが出力されるため、セットは一貫性を保ち、数値を編集するだけで任意の形状を微調整できます。任意のアスペクト比、紙の色、サイズに対応します。

エンジンセットアップ(プロジェクトごとに1回): レンダラーは references/engine.md 内のコードブロックとして提供されます。次のコマンドでコピーしてください。再入力は避けてください:

awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py

ここで DIR はプロジェクトのアートフォルダ(またはスクラッチフォルダ)です。同じコマンドで references/example_drawings.md を描画ファイルとして変換することもできます。実行は python3 paper.py ... で行います(numpy と opencv-python が必要)。以下のコマンドはこのファイルが存在することを前提としています。既に paper.py がある場合は、それを再利用してください。

ルック(厳守)

描画を始める前に references/style.md を読んでください。簡単に言うと:大きな形状は少なめ;ノード数は少なく、長い弧を持つ;本当の角は角としてマークする;素材ごとに2~3トーン(ベース、影、場合によってはハイライト);影は親の中にクリップされたクリーンな形状で、多くの場合1つの硬いエッジと1つのフェードエッジを持つ;形状の周りにアウトラインは無し;線はペン線がある場所だけ(眉、まぶた、口、折り目)で、必ず先細りにする;ほのかな赤み(ブラッシュ)だけが唯一のぼかし;暖かみのあるオフホワイトの紙と、全体にわたる細かく均一な粒子。

ワークフロー

  1. 描画ファイルをセットアップする プロジェクト内に(例:Tools/art/drawings.py)作成し、DRAWINGS = {"name": {...}} を保持します。フォーマットは paper.py のドックストリングにあります(python3 paper.py を引数なしで実行すると表示されます)。 references/example_drawings.md の描画ファイルを起点にしてください。
  2. オーサリンググリッドを選び、可能であればそのグリッド上に配置された参照画像(スケッチ、絵画、承認済み画像)を用意します。既知のスケールでノード座標を読み取ります。h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p] のような小さなラムダ式で、参照画像のピクセルから変換できます。
  3. マスクから形状をラフに起こす(有用な場合):領域の白黒マスク(色の閾値、手動マスク)を作成し、python3 paper.py nodes MASK.png [scale] を実行します。コーナーが検出されたノードが出力されます。その後、手作業でノードを間引き、整えます。この手作業のパスによって、なぞったのではなく切り抜いたように見えます。
  4. レンダリング:python3 paper.py path/to/drawings.py OUT_DIR [name …] → OUT_DIR/<name>.png。
  5. 見て、比較し、調整する。 結果を参照画像(または承認済みセット)の隣に、実際に見られるサイズで並べて表示します。例:ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png で開きます。一度に1つずつ修正します:ノード、トーン、クリップ。数ラウンドを見込んでください。オーナーが承認したらコミットします。
  6. 納品 はプロジェクトのサイズとフォーマットで行います(Lanczosでダウンスケール、JPEGは q≈88、またはPNG)。画像は2K以下に保ちます。プロジェクトがアートに透かしを入れる場合、承認後に、出荷前にシールを施します。

既存のセットに合わせる

新しい絵を、すでにルックが確立しているセット(承認済みのアバターに新しいものを追加するなど)に加える場合、順序は ルールを第一に、次に描画、そして反復 です:

  1. リファレンスを研究し、ルールを書き留める。 拡大して測定します:エッジの作り方、素材ごとのトーン、影の形状の位置と太さ、頭部の軸上の特徴的なサイズと位置、頭部がフレームに占める割合、紙の色と粒子。
  2. キャリブレーション:ブラシでリファレンスの1つを再描画し、オリジナルと並べて、一致するまで調整します。
  3. スタイルを伝えるパーツ(目、眉、耳の内部)をリファレンスから抽出する: python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2 は、ピクセルX,Yの下にあるフラットな形状を、その頭部の軸上のノードとして出力します。オーバーレイして確認します。肌の上にシードポイントがある場合は移動します。
  4. ソース上に描画する: python3 paper.py grid SOURCE.jpg grid.png でグリッド入りのコピー(20pxごとに線、100pxごとにラベル)を生成し、座標を読み取ります。形状あたりのノードは少なめに:顔は約16、髪の毛は20~40。
  5. 誰かに見せる前に混ざり込みテストを行う: 新しい絵とリファレンスを1つのグリッドにインターレースし、サムネイルサイズ(約480px)で表示します。もし新しい絵が見分けられたら、まだ完成していません。次に、それぞれの絵を最も近いリファレンスの隣にフルサイズで確認します。

うまくいかないこと:想像から形状を作ること(すべての顔が同じになります);リアルな絵画を色でトレースすること(その塊をコピーします);リファレンスを自動ベクター化すること(斑点状になります);リアルな顔から特徴の位置をそのままコピーすること(口が低くなりすぎ、顔が長く老けて見えます);絵画の暗い領域から影の形状を取ること(汚れのように見えます)。

自分の頭部の軸上の典型的な顔の配置(自分のセットで測定):眉は y −0.8 付近、目のラインと平行;鼻は遠い側の短いフック、x −0.3 から −0.65、y 0.45 から 1.15;口は幅約1.1単位で y 1.6 から 1.8、目とほぼ平行、両端の高さはほぼ同じ(端が上がっていると冷笑に見えます);あごは y 2.8 から 3.1。すべてのキャラクターに独自の髪型シルエット、目と眉の形、パレットを与えないと、セットは同じ顔に収束します。きついカール、三つ編み、ウールには scallop() を;ニットの襟には ribs() を;レンズやボタンには oval() を使用します(from paper import scallop, ribs, oval)。

顔:再利用可能なパーツ

一貫性のある顔のセットを作るために、各描画に "eyes": ((x, y), (x, y)) を指定します。これにより頭部固有の軸(x軸は目のライン、y軸は顔の中心線、単位 = 両目間の距離の半分)が定義され、特徴を一度記述すれば任意の頭部で使用できます:

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} — ノードをヘッド単位で指定(幅も同様)。
  • {"part": ("setname", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} — parts.py(描画ファイルの隣に配置)からパーツを取得:PARTS = {"setname": {"eye_l": {"nodes": [...]}, ...}}、ノードはヘッド単位。パーツは承認済み画像から一度リフト(パーツのマスクを nodes でトレースし、ヘッド単位に変換)すれば、新しい顔で再利用でき、セット全体が同じ手で描かれたように見えます。
  • "mirror": True で描き直さずに顔の向きを反転できます。

ハマりどころ

  • 形状は順番に描画されます。"clip" は同じ "name" の下で既に描画された形状のみを参照します。
  • 同じ "name" を持つ複数のレイヤーは結合(ユニオン)されます。ボディが複数のパーツで構成される場合に便利です。
  • "fade" ポイントはグリッド座標。最初のポイントで強く、2番目のポイントで消えます。
  • "soft" はグリッド単位。ほのかな赤み(ブラッシュ)とグローのみに使用してください。
  • 描画ファイル内で from paper import flow, scallop, ribs, oval とインポートできます。エンジンフォルダがパスに含まれています。
  • 描画を多数の小さな形状やアウトラインにさせないでください。詳細に線が必要な場合は、代わりに2番目のトーンの形状で表現した方が良いか検討してください。

関連スキル