本文へ移動
cccskills
無料GitHub で公開

marp-deck-export

5〜10 分のプレゼン資料を Marp(Markdown)で作成し、PDF / PPTX / HTML に書き出す。会話やリポジトリの実状況からスライドを起こし、gaia テーマの雛形で下書き → docs/slides/YYYY-MM-DD_slug.md に保存 → ヘルパースクリプトで描画する。

「プレゼン資料を作りたい」「スライド」「発表資料」「Marp」「Google スライド用の pptx」 などに言及されたときに使用する。

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.1 KB
  • assets/marp-template.md1.8 KB
  • scripts/render_deck.sh1.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Marp Deck Export

Goal

会話やリポジトリの実状況から、5〜10 分で話せるプレゼン資料を Marp Markdown で作り、 PDF / PPTX / HTML に書き出す。正(source of truth)は .md、描画物は生成物として扱う。

Workflow

  1. 文脈を集める: まず現在の会話から。不足分だけリポジトリ・PR・docs/・実データで補う。 リポジトリを題材にする発表なら、実ソース(コード・docs/plan/・設定)を読む。憶測で書かない。
  2. スラッグと構成を決める: 短い kebab-case スラッグを選ぶ。対象読者・長さが曖昧なら確認する。 目安は 1 スライド 20〜40 秒 → 5〜10 分で 10〜16 枚。
  3. 下書き: assets/marp-template.md の雛形(gaia / 16:9)をベースにスライドを書く。
  4. 保存: docs/slides/YYYY-MM-DD_<slug>.md に置く(ディレクトリが無ければ作る)。
  5. 描画: ヘルパースクリプトで書き出す(下記 Rendering)。
  6. 検証: エラーなく描画され、スライド枚数が想定どおりで、はみ出し・配色崩れが無いこと。

Content rules

  • 数値・固有名詞は実データで裏取りする。統計は gh やファイルからその場で数え直す。 計画文書の古いスナップショット値をそのまま転記しない(実態とズレる)。
  • 1 スライド 1 メッセージ。箇条書きは短く。図や ASCII はフェンスドコードブロックで置く。
  • ユーザーの言語・トーンに合わせる。ソースに無い主張を足さない。
  • 曖昧な口語表現を避け、正確な言い回しにする。短く書くために意味をぼかさない。 例: 「修正したコードを出す」→「修正したコードをデプロイする」「修正したコードをリリースする」 「修正したコードを main に反映する」のように、対象と操作が特定できる語を選ぶ。 書き上げたら全スライドを見直し、同じ曖昧語が残っていれば同じ基準でまとめて直す。

Styling gotchas

  • テーマは gaia。アクセント色などは frontmatter の style: ブロックで定義する。
  • code {} に背景色・文字色を付けたら、pre / pre code も必ず別に指定する。 さもないとインラインコード用の配色がブロックコード(ASCII 図など)にも効いてコントラストが死ぬ。 pre は濃色背景(例 #161b26)+淡色文字(例 #e8ecf8)にすると図がくっきりする。

Rendering

skills/marp-deck-export/scripts/render_deck.sh <deck.md> [formats]
  • formats は既定 pdf。pdf,pptx,html のカンマ区切りで複数指定可。
  • --pdf と --pptx は 1 回の marp 実行で同時指定できない → スクリプトは形式ごとに実行を分ける。
  • PDF / PPTX はヘッドレス Chromium を使う。The browser is already running や起動エラーで落ちるのは サンドボックスが Chromium をブロックしているサイン。サンドボックス外で再実行する(/sandbox で調整可)。 HTML は Chromium 不要。

Google スライドで使う場合

pptx を書き出し → Google ドライブにアップ → 「Google スライドで開く」でインポートする。

Files

  • assets/marp-template.md — スライドの骨格 + テーマ(コピーして使う雛形)
  • scripts/render_deck.sh — pdf / pptx / html への描画ヘルパー

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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.

日本語の概要は準備中です。原文の説明を表示しています。

hodanov/my-pde32026年10月12日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

hodanov/my-pde32026年10月12日 更新

commit-and-draft-pr

無料日本語概要

変更をコミットしてドラフト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直接実行しない。

hodanov/my-pde32026年10月12日 更新

commit-split

無料日本語概要

1 つの作業ツリーに混ざった差分を、変更理由ごとの意味単位のコミットへ分割する。ユーザーが「コミットを分割して」「意味単位で分けて」「commit-split」等を求めたとき、または機能追加・付随リファクタ・設定/ドキュメント修正が 1 コミットに混在していると気づいたときに使用する。分割案を提示して承認を得てからステージし、コミットごとに単独で成立することを確認する。メッセージ規約・push・PR の作成は commit-and-draft-pr へ委譲する。

hodanov/my-pde32026年10月12日 更新

credential-leak-prevention

無料日本語概要

gitleaks + pre-commit を使ってローカルコミット時のクレデンシャル混入を機械的にブロックする。「クレデンシャル漏洩防止」「シークレット混入対策」「gitleaks」「pre-commit シークレット」「credential leak prevention」に言及した場合に使用する。

hodanov/my-pde32026年10月12日 更新

dependency-update

無料日本語概要

依存パッケージ(Go modules / npm / Terraform provider / GitHub Actions / pre-commit 等)の アップグレードを、outdated 検出 → CHANGELOG・破壊的変更の確認 → 更新 → lint/test 検証 → コミットまで一連の手順で安全に適用する。「依存更新」「パッケージを上げて」「dependency update」 「go get -u」「npm update」「provider を上げる」等に言及されたときに使用する。

hodanov/my-pde32026年10月12日 更新

hodanov のスキルをすべて見る

このスキルの問題を報告する