- name
SKILL.md
स्किल फ़ाइल पब्लिशर की रिपॉज़िटरी में ही रहती है।
कॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add minorun365/minorun-marp-skill --skill slide-design-dark -a cursor -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add minorun365/minorun-marp-skill --skill slide-design-dark -a claude-code -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add minorun365/minorun-marp-skill --skill slide-design-dark -a codex -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add minorun365/minorun-marp-skill --skill slide-design-dark -a grok -yकॉपी किया गया संदेश Grok Bot चैट में भेजें। Bot यह SKILL.md GitHub से लाता है और उसे उन स्किल में जोड़ देता है जो आपके सभी Bot साझा करते हैं।
Install this skill: https://github.com/minorun365/minorun-marp-skill/tree/HEAD/skills/slide-design-darkपब्लिशर से
黒地のスライドは、白地より粗が目立つ。余白の不揃い、沈んだ色、下端に張り付いた図は、投影した瞬間に分かる。このスキルは、作者(みのるん)が黒地テーマで登壇資料を作るなかで固めた規則と検査をまとめたもの。
テーマ本体は theme/minorun-dark.css、検査スクリプトは tools/ にある。
---
marp: true
paginate: true
theme: minorun-dark
---
**太字** は黄色、*斜体* は薄いシアンで表示される<style> か、そのスライドだけの <style scoped> に書く「もう少し上へ」「余白をあけて」と言われて、値を勘で足し引きしない。根拠の無い数字で触ると、直したつもりの箇所が別の要素とぶつかり、同じ指摘を何巡も受ける。
mutool draw -F stext -o - deck.pdf | rg '<line bbox=' # 本文の行ごとの位置
塗りの面(ボックスや帯)はテキスト抽出に出ないので、ページを画像に焼いて色の連なりから取る。測ったら、位置を足し算ではなく規則で決める。
左右の余白が167対168、上下が60対65のように両側の差が数pxなら、バランスは取れている。ずれていたら、その数字がそのまま直す量になる。
PDFの座標は960×540、MarpのCSSは1280×720が基準なので、係数0.75を掛けて換算する。
素材を差し替えただけで見せない。図や写真を入れ替えたら、同じ作業のなかで幅、四方の余白、見出しとの間隔、隣の要素との重なりまで整える。入れ替えは作業の半分で、残りの半分がレイアウトの調整である。
position: relative; top: <差の半分>px で下げるsection は display: block なので、margin: auto 0 では縦中央に寄らない。表も display: block なので、中央へ寄せるには display: table; width: auto; margin: <上の空き> auto 0 と書くデザインの直し方を発明しない。バランスが悪いと言われたら、まず同じ構成のスライドを過去のデッキから探して真似る。新しいCSSの型を作るのは最後の手段で、作るなら先に1スライドだけ試して見せる。
感覚で色を選び直さない。黒との明度比、トーン、面積の3つの物差しで決める。
def lin(c):
c /= 255
return c/12.92 if c <= 0.03928 else ((c+0.055)/1.055)**2.4
def L(h):
h = h.lstrip('#'); r,g,b = (int(h[i:i+2],16) for i in (0,2,4))
return 0.2126*lin(r) + 0.7152*lin(g) + 0.0722*lin(b)
def vs_black(h): return (L(h)+0.05)/0.05 # 黒背景との比
def vs_white(h): return 1.05/(L(h)+0.05) # 上に乗せる白文字との比
基準として、シアン #00c4e4 は10.0、純黄 #ffff00 は19.6である。見出しの色が10を切ると、濃く沈んで見える。
本文に置いて読ませる補足ボックスを、脇役の箱と同じ1.5で作らない。背景と同化する。作者の例では #2f2f37(1.58)が沈み、#555561(2.86)で枠が立った。上限を決めるのは枠の中に置く強調色で、黄色の強調を載せるなら、地と黄色の比が6を切らないところで止める。
面を明るくするほど白文字が読めなくなる。白の大きな太字(25pt前後)を乗せるなら白との比3.0が下限、図の中の小さめの文字(17〜19px)なら4.0以上。白文字のまま面をもっと明るく、という要望は両立しないので、上限にあることを数字で示してから文字色を変える案を出す。
同じ色を、大きな塗りの面と細い文字の両方に使うと、面は明るく、文字は沈んで見える。「表紙の色はいいのに本文の色が濃い」と言われたら、まずこれを疑う。文字と細い線に使う色を、面の色より1〜2段明るくする。明度比が倍近く違っても、画面ではだいたい同じ明るさに見える。
色相環の距離だけで判断しない。明度と彩度が揃っていないほうが、原因として多い。片方が白を含む淡い色で、もう片方が原色だと、色相が近くてもぶつかる。
直す順番は、まず明度と彩度を相手に寄せる、それでも駄目なら色相を離す、である。色相を動かすと色の意味まで変わる(黄色の強調を緑にすると「成功」に読める)ので、最後の手段にする。
黒地の表や図がのっぺりして見えるなら、全部が白(明度比21)になっている。主役の色は動かさず、見出し、罫線、ラベルのほうを落として段差を作る。段差は倍々が目安(21 → 10 → 6 → 3)。1.5倍以内では変えた気がしない。投影する資料のヘッダは10前後で止める。会場のプロジェクタは黒が浮くので、7を切ると読みにくい。罫線は色と一緒に太さも落とす。
公式サイトのCSSやドキュメントの設定から色コードを取る。ブランド色をそのまま文字に使うと黒地では読みづらいので、用途で明度を変える。
白地のデッキから黒地版を派生させるとき、図の色だけを機械置換して済ませない。白地向けの濃い青のグラデーションの図形や、明るい色のベタ塗りの箱は、黒地では浮く。図形は暗いグレーの面(上から下へ #2c2c35→#18181e、枠 #3c3c46)に白文字にし、主役の1つだけを濃いティール(#00788c)のベタ塗りに白抜きで立てる。
色見本や数字だけでは決まらない。同じページを候補の数だけ書き出して、2×2のグリッドに並べる。本文の強調が乗るスライドと、図の中で使われるスライドの2つで比べる。1つだけだと、図の中の他の色との相性を見落とす。
部品だけを切り抜いた見本で選ばせない。色の見え方は前後のページとの並びで変わるので、デッキの数ページを通して書き出し、同じ色を使うほかの成果物(同じテーマのWebページなど)があれば同じ条件で撮って、いまの色と各案を横に並べる。
フォントも同じで、言葉で相談せず書き出して見せる。候補ごとに表紙・箇条書き・表の3ページを書き出して並べる。
「気にしない色」を除外条件にした検索を使わない。同じ行に対象の色と除外する色が両方あると、行ごと消えて見落とす。置き換える色そのもので探し、置換後に旧色が0件になることを確かめる。SVGに残りやすい。
rg -n -i '#00c4e4|#5ec4d0|#a8e0e8' deck.md images/*.svg
**太字** を使わない。テーマ既定の表はセルがグレーなので、黄色が沈むどれも、何度か作り直して落ち着いた形である。
テーマ既定のグレー地の表も、黒いカード地にテーマ色の小見出しを付けた表も、洗練されて見えなかった。通ったのは、地を塗らず細い罫だけの形。
table { display:table !important; width:100% !important; border-collapse:collapse !important; background:transparent !important; border:none !important; font-size:22pt; }
table thead, table tbody, table tr { background:transparent !important; border:none !important; }
table th { background:transparent !important; color:#a09aa4 !important; font-weight:600; font-size:18pt; letter-spacing:.06em;
text-align:left; padding:0 .7em .55em; border:none !important; border-bottom:1px solid #3a3640 !important; }
table td { background:transparent !important; color:#e9e6ec !important; padding:.5em .7em; line-height:1.4;
border:none !important; border-bottom:1px solid #221f28 !important; vertical-align:top; }
table tr:last-child td { border-bottom:none !important; }
table td:first-child { color:#ffffff !important; font-weight:700; white-space:nowrap; }
td だけを透明にすると、テーマ既定の tr の背景が透けて、白地に白文字になる。table / thead / tbody / tr にも必ず当てるdisplay: table !important と width: 100% !important の両方を書く。Marp 既定の display:block; width:max-content が残り、width:100% だけでは版面の7割で止まるwhite-space: nowrap を当てて、はみ出したら文言を削る。自動の折り返しに任せると、最後の1文字だけが2行目に落ちるrgba(255,226,120,.16))。6行以上の比較表では必須td の padding を詰めるテーマ既定の白地の pre も、黒いウィンドウに信号機のドットを付けた形も、通らなかった。通ったのは、半透明のグラデーションの地に、上端へテーマ色のラインを引き、文字はモノトーンで要点だけ色を付けた形。
.win { position:relative; border-radius:18px; margin:8px 0 28px; padding:22px 0 4px; overflow:hidden;
background:linear-gradient(165deg, rgba(255,255,255,.10) 0%, rgba(255,255,255,.045) 100%);
border:1px solid rgba(255,255,255,.14); box-shadow:0 18px 44px rgba(0,0,0,.45); }
.win::before { content:""; position:absolute; left:0; right:0; top:0; height:3px;
background:linear-gradient(90deg, #00c4e4 0%, #7fe3f5 45%, rgba(127,227,245,0) 100%); }
.win pre { background:transparent !important; box-shadow:none; margin:0; padding:0 28px 16px; font-size:21.5pt; line-height:1.15; }
.win pre code { color:#f2f1f5; }
本文の下の空きへ、濃い灰色の角丸ボックスを置き、補足の1行を入れる型。
.gbox { position: absolute; left: 0; right: 0; margin: 0 auto;
width: fit-content; min-width: 990px; max-width: 1088px;
bottom: 64px; background: #555561;
border-radius: 18px; padding: 16px 70px; text-align: center; }
.gbox, .gbox p { font-size: 27pt; line-height: 1.38; }
.gbox p { margin: 0; }
.gbox.up { bottom: 104px; } /* 本文が短く、下の空きが広いスライド */
left:50% と translateX(-50%) で中央に寄せない。使える幅が画面の右半分だけになり、収まるはずの文が折り返すmin-width で、複数のスライドのボックス幅を揃える。いちばん長いスライドの自然な幅を測って下限にするfont-size は .gbox と .gbox p の両方に当てる。div の中のMarkdownは <p> が生成されないことがある結論や引用の箱を、明るい色のベタ塗りに濃い色の文字で作らない。黒地では浮いて見える。薄い網掛けも沈んで読めない。半透明の白を重ねたガラス調の面も、黒地に溶けて、本文と本文のあいだに仕切り線があるだけに見える。結論は補足ボックスと同じ濃い灰色のベタ塗りに白の太字、引用は左端のテーマ色の縦線で分ける。
/* 結論:濃い灰色のベタ塗りに白の太字 */
.callout { width: 88%; margin: 0 auto; border-radius: 18px; padding: 22px 40px;
background: #555561; color: #ffffff; font-weight: 700; text-align: center; }
/* 引用:枠線なし。左端のテーマ色の縦線 */
.quote { position: relative; border-radius: 4px 12px 12px 4px; padding: 18px 36px;
background: linear-gradient(180deg, rgba(255,255,255,.075), rgba(255,255,255,.02)); }
.quote::before { content: ""; position: absolute; left: 0; top: 0; bottom: 0; width: 3px;
background: linear-gradient(180deg, #00c4e4, rgba(0,196,228,0)); }
箱の形は好みが割れやすい。同じスライドに2〜3案を当てて並べ、選んでもらう。
吹き出しやコラムの箱は、箱の幅を文字に合わせ、段落の間を空ける。
width: fit-content; max-width: 100% にする。幅いっぱいの箱に短い行を並べると、右側だけ空いて左に寄って見える<p> を2つにし、p + p { margin-top: 14px; } で間を空ける。p { margin: 0 } のまま改行だけで続けない黒地の図は、白地の図の色を替えて作ることが多い。すると、白地の側に後から入った直し(配置の変更、サブラベルの撤去、窮屈さの解消)が黒地版へ届かない。
tools/check-svg-contrast.mjs で測る。吹き出しを箱と同じ暗いグラデーションで塗ると消える--png <dir> で黒地の上に大きく描き出し、1点ずつ目で見る。スライドに縮めた状態では、吹き出しの潰れも枠からのはみ出しも見えない<style scoped> に残った白地用の文字色も消す。濃い紺やグレーの文字色は、黒地ではほぼ読めない。白地のテーマで使っていた色コードを rg -n -i で引いて0件にする「0.35秒と1.34秒」のような比較は、数字を88ptで2つ並べ、下に1行。細い縦線1本で左右を分ければ足りる。料金の行や注記を足すと、文字が詰まり配色が崩れる。
箱の中には中身だけを入れる。箱が何であるかの名前は、箱の上14pxに小さく置く。
![bg right:40%] で置くと右端に密着する。![w:720 center] で中央に置き、border-radius:14px を掛ける。2枚を左右に並べるときは、縦横比を揃える。片方だけ縦長だと、説明の開始位置が左右でずれる。
全角の開き括弧(「『()に隣接する **強調** は効かず、アスタリスクがそのまま出る。<strong> で書く。書き出したPDFで確かめる
mutool draw -F stext -o - deck.pdf | grep -c 'c="\*"' # 0 が正常
div の中でMarkdownの強調を効かせるには、開きタグの直後と閉じタグの直前に空行を入れる
</div> の直後に空行なしで --- を書くと、スライドの区切りとして認識されず、ページが1つ減る。スクリプトでタグを削除したあとは、ページ数を確かめる
普通の本文の行の直後も同じ。空行なしで --- が続くと、Markdown がその行を見出し(setext 見出し)として読み、前後2つのスライドが1ページにくっつく。スクリプトでスライドを差し込む・入れ替えるときは、区切りを必ず \n\n---\n\n にする
<img> のインライン style 属性は落とされる。クラスで書く
mdを \n---\n で分割すると、先頭はフロントマターになる。最初のスライドは2番目の要素で、そこにはデッキ全体の <style> が同居していることが多い。表紙を作り直すつもりで丸ごと置き換えると、全ページのスタイルが消える。症状は表紙ではなく他のページに出る
スクリプトでスライドを削除や挿入するときは、番号の降順で処理する。実行前に、対象の中身を assert で確かめる
「p36を直して」のpは、書き出したPDFのページ番号である。原稿の --- を数えて対応付けると、フロントマターの区切りの分だけずれる。そのページだけ画像に焼き、写っている文言で原稿を検索して直す
pdftoppm -png -r 80 -f 36 -l 36 deck.pdf /tmp/p36
標準フォントしか使えない会場では、<style scoped> の独自フォント指定を標準フォントへ差し替える
生のHTMLブロック(<p>…</p>)の中の改行は、Marp の改行(breaks)として扱われず無視される。意図した位置で折るなら、タグで囲まず素のMarkdownの行として書く
逆に、素のMarkdownの行末に <br> を書いて次の行へ続けると、<br> と素の改行の両方が改行として扱われ、1行ぶん空く(表紙の会社名と名前の間が開く、など)。見出しの途中の <br>(# 1行目<br>2行目)は1行の中なので問題ない。生のHTMLブロックの中では <br> が要る。書いたら拾う
rg -n '<br>\s*$' deck.md # HTMLブロックの外でヒットしたら <br> を消す
Marpは、版面からコンテンツがあふれてもエラーを出さない。書き出すたびに検査を通す。
marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files
python3 tools/check-dark-margins.py deck.pdf # 中身の下端と右端の空き。60px未満でNG
python3 tools/check-dark-gaps.py deck.pdf # 画像、図、コードの箱と隣の本文の間隔。36px未満でNG
python3 tools/check-figure-text.py deck.pdf # 図の中の16pt未満の文字、縁まで14px未満の文字
node tools/check-svg-box-fit.mjs images/*.svg # SVGを描画して文字と枠の余白を実測
node tools/check-svg-contrast.mjs images/*.svg --png /tmp/svg # 図形と真下の面の明度比。1.25未満でNG
python3 tools/check-line-breaks.py deck.pdf # 改行の過不足。1行10字台の積み上げ、読点の後ろの切れ端、原稿に無い自動折り返し
黒地の下端は、テキストの位置ではなく、黒でないピクセルの最下行で測る。コードの箱も図も挿絵も拾える。
改行の検査は、同じ場所にある同名の .md と照合して、原稿で改行したのか自動で折り返したのかを見分ける。改行のしすぎと足りなさは目で見逃しやすいので、NGのページは画像で見てから直す。
NGは全件を列挙してから要約する。先に要約すると、3件目を見落とす。
検査が全部OKでも、目視は省けない。検査は存在する要素を測る仕組みなので、要素が丸ごと描かれなかった崩れは1つも検出できない。検査OKの報告と、目視の報告は分けて書く。
pdftoppm -png -r 55 deck.pdf /tmp/all/p # 全ページを小さく焼き、数ページずつ貼り合わせて順に見る
目視でしか捕まらないものは、文字と挿絵や図形の重なり、下方向の余白のつぶれ、矢印の軸が隠れて矢尻しか見えない状態、見出しの大きさや位置のページ間の不揃い、不自然な改行、挿絵の入れ忘れ、挿絵とキャプションの密着、リード文と図形の間隔の詰まり、本文が左へ寄って右が空く配置である。
吹き出しのしっぽ、矢印、帯のように、別の図形を要素の上に重ねたものは、縮小した全ページ画像では合格に見える。崩れるのは付け根や継ぎ目の数pxで、そこは縮小画像では1〜2ピクセルにつぶれている。重ねたページだけ高解像度で焼き直し、付け根の周囲を300%に拡大して見る。
mutool draw -r 200 -o hi.png deck.pdf 2
magick hi.png -crop 420x300+880+500 +repage -resize 300% tail.png
貼り合わせた一覧画像で見たことを「全ページ崩れなし」と報告しない。写真と罫線の重なり、余分な空白、文字のはみ出しは、この解像度では消える。崩れなしと書いてよいのは、1ページずつ150dpi以上で見たときだけである。見ていないなら「一覧で通して見た。原寸では未確認」と書く。
デッキを組んだら・組み直したら、話し手へ見せる前に全ページを1ページ幅1000px以上(合成するなら2×2まで)で見る。報告の書き方ではなく、見せる前の手順として毎回やる。引用枠・吹き出し・仮置きの枠の中の文が語の途中で折り返していないかを1つずつ確かめる。依頼文やプロンプト例は句の切れ目に <br> を入れ、枠の文字サイズはデッキの中で1つに揃える。箱と、箱の中の段落の両方に当てないと、段落と箇条書きで文字サイズが割れる。
一覧画像を作るときは、各ページの画像の幅を揃える。解像度の違う画像を先頭のページの幅のキャンバスへ並べると、広いページの右端が切れて、はみ出しているように見える。
1ページを直したら、同じ観点で全ページを点検してから報告する。1ページの指摘は、そのページの指摘ではなく検査の指示である。同じ条件を全ページに機械で当て、一覧を出してから直す。直したら同じ検査をもう一度全ページに当て、0件になったことを報告に書く。
黒地のMarpテーマ(minorun-dark)でスライドを組むときのデザインバランスと検査。余白の測り方、縦のバランス、配色の決め方、表・コード・補足ボックスの確定デザイン、Marp固有の罠、書き出し後の検査手順。「スライドのバランスを整えて」「色を変えて」「余白が変」「黒地のテーマで作って」と言われたら読む。
---name: slide-design-darkdescription: 黒地のMarpテーマ(minorun-dark)でスライドを組むときのデザインバランスと検査。余白の測り方、縦のバランス、配色の決め方、表・コード・補足ボックスの確定デザイン、Marp固有の罠、書き出し後の検査手順。「スライドのバランスを整えて」「色を変えて」「余白が変」「黒地のテーマで作って」と言われたら読む…---# skills/slide-design-dark/SKILL.mdFAQ
पब्लिशर से skills/slide-design-dark/SKILL.md डाउनलोड करें, या पाथ कॉपी करके रिपॉज़िटरी खोलें। PlugMCP स्किल को सूचीबद्ध करता है, फ़ाइल होस्ट नहीं करता।
पब्लिशर इसे https://github.com/minorun365/minorun-marp-skill पर रखता है।
Claude, Cursor, Codex और Grok Build वह SKILL.md पढ़ सकते हैं जिसे आप पब्लिशर की रिपॉज़िटरी से जोड़ते हैं। जब आप चैट में स्किल के GitHub फ़ोल्डर का लिंक भेजते हैं, तो Grok Bot उसे इंस्टॉल कर देता है।