5〜10 分のプレゼン資料を Marp（Markdown）で作成し、PDF / PPTX / HTML に書き出す。
会話やリポジトリの実状況からスライドを起こし、clean テーマの雛形で下書き → docs/slides/slug/YYYY-MM-DD_slug.md に保存 → 文字量と画像の lint → 初見の読み手テスト（cold read）→ PNG で崩れを確認 → 初見の人の目が行く所のテスト（glance test）→ 描画する。
「プレゼン資料を作りたい」「スライド」「発表資料」「Marp」「Google スライド用の pptx」 などに言及されたときに使用する。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
会話やリポジトリの実状況から、5〜10 分で話せるプレゼン資料を Marp Markdown で作り、
PDF / PPTX / HTML に書き出す。正（source of truth）は .md、描画物は生成物として扱う。
文字量と画像の中の文字の大きさは lint で、意味が伝わるかは cold read で、崩れは PNG で、
見てほしい所に目が行くかは glance test で確かめてから書き出す。
docs/・実データで補う。
リポジトリを題材にする発表なら、実ソース（コード・docs/plan/・設定）を読む。憶測で書かない。class: handout）。長さが曖昧なら確認する。
ユーザーへの確認は 1 回の質問にまとめる。
目安は 1 スライド 20〜40 秒 → 5〜10 分で本文 10〜14 枚（表紙・目次・扉・まとめは別）。
聞き手のペルソナを 1〜3 行で書く。聞き手が知っている語・知らない語も書く（cold read にそのまま渡す）。references/writing-rules.md の 8 項目を満たすかを見てから本文を書く。
図・グラフ・スクショ・表・コード・大きな数字を置くスライドには、証拠の型と**見てほしい所（1 か所）**を見出しに添える。
型は references/visual-rules.md の「証拠の型を選ぶ」から選ぶ。assets/marp-template.md（clean テーマ / 16:9）をコピーして書く。
文字量の上限は lint/slide-density.markdownlint-cli2.jsonc、文の書き方は references/writing-rules.md、
図・グラフ・スクショ・強調は references/visual-rules.md、それ以外の判断は references/design-rules.md に従う。docs/slides/<slug>/YYYY-MM-DD_<slug>.md に置く（ディレクトリが無ければ作る）。
画像は同じディレクトリの assets/ に置き、デッキからは assets/<画像> で参照する。
同じ題材の別版（配布用・作り直し）は、既存の docs/slides/<slug>/ に日付や -handout を付けた名前で並べる。scripts/lint_deck.sh <deck.md> が通るまで直す。文字量の直し方は design-rules.md の「文字を減らす順序」に従う。
画像の中の文字が小さすぎるという指摘は、visual-rules.md の「スクショ」「図とグラフ」に従って切り抜くか描き直す。
このステップでは PNG を見ない。scripts/extract_visible_text.sh <deck.md> で見える文字だけを取り出し、
会話を引き継がない新しいサブエージェント（Claude Code なら general-purpose。fork は会話を引き継ぐので使わない）に
references/cold-read.md のプロンプトで読ませる。指摘を直したら lint を再実行する。scripts/render_deck.sh <deck.md> png を実行し、一覧画像（sheet-*.png）を見る。
design-rules.md のチェックリストで気になるスライドだけ原寸の PNG を開く。直したら再描画し、直したスライドだけ見直す。blur/）を、
会話を引き継がない新しいサブエージェントに references/glance-test.md のプロンプトで見せる。
目立つ所が見てほしい所と違えば visual-rules.md で直し、lint と PNG を再実行する。scripts/render_deck.sh <deck.md> pdf,pptx など。
発表者ノートは PPTX のノートと HTML の発表者ビューに入る。gh やファイルからその場で数え直す。
計画文書の古いスナップショット値をそのまま転記しない（実態とズレる）。references/writing-rules.md）。
lint を通すために文字を減らすときも、主体・対象・単位のような意味を運ぶ語は削らない。clean（assets/themes/clean.css）。色・余白・レイアウトはテーマで決まるので、デッキに style: を書かない。
見た目を変えたいときはテーマを直す（全デッキに効く）。code {} に背景色・文字色を付けたら、pre / pre code も必ず別に指定する。
さもないとインラインコード用の配色がブロックコードにも効いてコントラストが死ぬ。<b> <a> <span> など）。
プレースホルダーや本文に <A> のような英字の山括弧を書かない。skills/marp-deck-export/scripts/lint_deck.sh <deck.md>
skills/marp-deck-export/scripts/extract_visible_text.sh <deck.md>
skills/marp-deck-export/scripts/render_deck.sh <deck.md> [formats]
formats は既定 pdf。pdf,pptx,html,png のカンマ区切りで複数指定可。png は一時ディレクトリに出力し、そのパスを表示する。ImageMagick があれば、ぼかした PNG（blur/）と 9 枚ずつの一覧画像 sheet-*.png も作る。--theme-set で読み込む。VS Code の Marp 拡張でプレビューするなら、markdown.marp.themes にテーマのパスを足す。--pdf と --pptx は 1 回の marp 実行で同時指定できない → スクリプトは形式ごとに実行を分ける。The browser is already running や起動エラーで落ちるのは
サンドボックスが Chromium をブロックしているサイン。サンドボックス外で再実行する（/sandbox で調整可）。
HTML は Chromium 不要。Chrome が無く Brave がある環境では Brave を使う（CHROME_PATH で上書き可）。npx）で動き、Chromium は不要。デッキは標準入力で渡すので、リポジトリ側の markdownlint 設定の影響を受けない。
画像はデッキのディレクトリからの相対パスで探し、PNG と SVG だけを測る。pptx を書き出し → Google ドライブにアップ → 「Google スライドで開く」でインポートする。
assets/marp-template.md — 構成の見本（コピーして使う雛形）assets/themes/clean.css — テーマ（色・余白・レイアウト用クラス）assets/charts/bar.svg — 横棒グラフの雛形（グレーの棒と 1 本のアクセント色、値の直接ラベル）references/design-rules.md — 用途・文字を減らす順序・構成・色・クラス・目視チェックリストreferences/writing-rules.md — 1 回で意味が取れる文の 8 項目（語と、文・スライドのつながり）・削ってよい語・書き換え例references/cold-read.md — 初見の読み手テストのプロンプトと結果の読み方references/visual-rules.md — 証拠の型の選び方・見て分かるかの 5 項目・スクショと図とグラフの作り方・書き換え例references/glance-test.md — 初見の人の目が行く所のテストのプロンプトと結果の読み方lint/slide-density.cjs — スライドごとの文字量と、画像の中の文字の大きさを確かめる markdownlint のカスタムルールlint/slide-density.markdownlint-cli2.jsonc — 文字量の上限と画像の下限（投影用 projection / 配布用 handout）lint/fixtures/ — lint の回帰テスト用デッキscripts/lint_deck.sh — 文字量と画像の lintscripts/extract_visible_text.sh — cold read に渡す、見える文字だけのデッキscripts/render_deck.sh — pdf / pptx / html / png への描画ヘルパー（png ではぼかした PNG も作る）scripts/test_lint_deck.sh — lint の回帰テスト（ルールや上限を変えたら実行する）No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Convert Claude markdown subagent files to Codex CLI TOML format. Parses YAML frontmatter and body, applies model/permission/tool mappings, and outputs to agents/codex/<name>.toml.
The English summary is being prepared. Showing the original description.
Create or update a Markdown blog draft from recent work and export it with `YYYY-MM-DD_slug.md` naming. Output directory can be set via environment variable or CLI option; if missing, ask the user and pass it explicitly.
The English summary is being prepared. Showing the original description.
変更をコミットしてドラフトPRを作成する一連のGit/ghワークフロー。ユーザーが「コミットして」「PR作って」「draft PR」等を求めたときに使用し、status/diff確認・命令形コミット・push・gh pr create --draft（--assignee hodanov）まで実行する。ユーザーの明示リクエストが無くても、実装完了後にcommitやPRが必要になった場面（dev-workflowのcommitフェーズ等）では必ずこれを使う。`git commit` や `gh pr create` を単体でBash直接実行しない。
The English summary is being prepared. Showing the original description.
1 つの作業ツリーに混ざった差分を、変更理由ごとの意味単位のコミットへ分割する。ユーザーが「コミットを分割して」「意味単位で分けて」「commit-split」等を求めたとき、または機能追加・付随リファクタ・設定/ドキュメント修正が 1 コミットに混在していると気づいたときに使用する。分割案を提示して承認を得てからステージし、コミットごとに単独で成立することを確認する。メッセージ規約・push・PR の作成は commit-and-draft-pr へ委譲する。
The English summary is being prepared. Showing the original description.
gitleaks + pre-commit を使ってローカルコミット時のクレデンシャル混入を機械的にブロックする。「クレデンシャル漏洩防止」「シークレット混入対策」「gitleaks」「pre-commit シークレット」「credential leak prevention」に言及した場合に使用する。
The English summary is being prepared. Showing the original description.
依存パッケージ（Go modules / npm / Terraform provider / GitHub Actions / pre-commit 等）の アップグレードを、outdated 検出 → CHANGELOG・破壊的変更の確認 → 更新 → lint/test 検証 → コミットまで一連の手順で安全に適用する。「依存更新」「パッケージを上げて」「dependency update」 「go get -u」「npm update」「provider を上げる」等に言及されたときに使用する。
The English summary is being prepared. Showing the original description.