publish-to-pages

プレゼンテーションやウェブコンテンツを一度に GitHub Pages に公開します。

1. 前提条件の確認

これらを静かに実行します。エラーのみ表示してください:

command -v gh >/dev/null || echo "MISSING: gh CLI — install from https://cli.github.com"
gh auth status &>/dev/null || echo "MISSING: gh not authenticated — run 'gh auth login'"
command -v python3 >/dev/null || echo "MISSING: python3 (needed for PPTX conversion)"

poppler-utils はオプション (PDF 変換用の pdftoppm)。これでブロックしないでください。

2. 入力検出

ユーザーが提供する内容から入力タイプを判定します:

入力	検出方法
HTML ファイル	拡張子 .html または .htm
PPTX ファイル	拡張子 .pptx
PDF ファイル	拡張子 .pdf
Google Slides URL	URL に docs.google.com/presentation を含む

提供されない場合は、ユーザーに リポジトリ名 を尋ねてください。デフォルト: 拡張子を除いたファイル名。

3. 変換

大型ファイル処理

両方の変換スクリプトは自動的に大型ファイルを検出し、外部アセットモード に切り替わります:

• PPTX: ファイルが >20MB または 50 個以上の画像を含む → 画像を assets/ に個別ファイルとして保存
• PDF: ファイルが >20MB または 50 ページ以上 → ページ PNG を assets/ に保存
• ファイルが >150MB の場合は警告を表示 (PPTX は PDF パスを提案)

これによって個別ファイルを GitHub の 100MB 制限より十分下に保ちます。小型ファイルは単一の自己完結した HTML を生成します。

--external-assets または --no-external-assets で動作を強制できます。

HTML

変換は不要です。ファイルを index.html として直接使用してください。

PPTX

変換スクリプトを実行します:

python3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html
# 大型ファイルの場合、外部アセットを強制:
python3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html --external-assets

python-pptx がない場合、ユーザーに告知してください: pip install python-pptx

PDF

付属スクリプトで変換します (pdftoppm 用に poppler-utils が必要):

python3 SKILL_DIR/scripts/convert-pdf.py INPUT_FILE /tmp/output.html
# 大型ファイルの場合、外部アセットを強制:
python3 SKILL_DIR/scripts/convert-pdf.py INPUT_FILE /tmp/output.html --external-assets

各ページは PNG として描画され、スライドナビゲーション付きで HTML に埋め込まれます。 pdftoppm がない場合、ユーザーに告知してください: apt install poppler-utils (macOS では brew install poppler)。

Google Slides

1. URL からプレゼンテーション ID を抽出します (/d/ と / の間の長い文字列)
2. PPTX としてダウンロード:

curl -L "https://docs.google.com/presentation/d/PRESENTATION_ID/export/pptx" -o /tmp/slides.pptx

3. 上記の変換スクリプトを使用して PPTX を変換します。

4. 公開

可視性

リポジトリはデフォルトで public として作成されます。ユーザーが private を指定した場合 (またはプライベートリポジトリを希望した場合) は、--private を使用してください — ただし、プライベートリポジトリの GitHub Pages には Pro、Team、または Enterprise プランが必要です。

公開

bash SKILL_DIR/scripts/publish.sh /path/to/index.html REPO_NAME public "Description"

ユーザーがリクエストした場合は public の代わりに private を渡します。

スクリプトはリポジトリを作成し、index.html (および存在する場合は assets/) をプッシュし、GitHub Pages を有効にします。

注: 外部アセットモードを使用した場合、出力 HTML は assets/ 内のファイルを参照します。公開スクリプトは自動的に assets/ ディレクトリを検出し、HTML ファイルと同じ親ディレクトリにコピーします。HTML ファイルとその assets/ ディレクトリが同じ親ディレクトリにあることを確認してください。

5. 出力

ユーザーに以下を伝えます:

• リポジトリ: https://github.com/USERNAME/REPO_NAME
• ライブ URL: https://USERNAME.github.io/REPO_NAME/
• 注: Pages は公開されるまで 1-2 分かかります。

エラーハンドリング

• リポジトリが既に存在: 番号 (my-slides-2) または日付 (my-slides-2026) を追加することを提案してください。
• Pages 有効化失敗: それでもリポジトリ URL を返してください。ユーザーはリポジトリ設定で Pages を手動で有効にできます。
• PPTX 変換失敗: ユーザーに pip install python-pptx を実行するよう伝えてください。
• PDF 変換失敗: poppler-utils のインストールを提案してください (apt install poppler-utils または brew install poppler)。
• Google Slides ダウンロード失敗: プレゼンテーションが公開アクセス可能でない可能性があります。ユーザーに表示可能にするか、PPTX を手動でダウンロードするよう尋ねてください。