Communitygithub.com

newkayak12/claude-skills

テンプレートからスライドを複製してコンテンツを埋め込むことで、MarkdownからPowerPointプレゼンテーションを構築します。手動でのスライド作成を不要にします。

claude-skills とは?

このスキルは、PowerPointプレゼンテーション(PPTX)を「タイプされたドキュメント」ではなく「ビルド成果物」として扱います。ユーザーはMarkdownソースファイル(`deck.mdx`)のみを編集し、スクリプト(`scripts/deck.py`)がテンプレート(`template.pptx`)のスライドを複製してコンテンツを差し替え、最終的な`deck.pptx`を生成します。デザインはテンプレートに完全に依存するため、テンプレートなしでは動作しません。また、スキルはカタログ(`catalog`)によるアーキタイプの確認、`check`によるオーバーフローの検出、そして`build`または`render`による最終出力を必須としています。さらに、`scripts/ppt_keycolor_changer.py`を用いて、テンプレートや既存のPPTXのキーカラーをブランドカラーに変更する機能も提供します。対応プラットフォームはClaude Code(Codex)を想定しており、AIエージェントがユーザーの指示(「PPT 만들어줘」「템플릿에 내용 채워줘」「발표자료 생성」「md로 PPT 만들기」「deck from markdown」「PPT 키컬러 변경」「브랜드 컬러로 교체」「recolor pptx」など)に応じて、テンプレートの取得からコンテンツのマッピング、MDXの作成、チェック、そしてビルドまでの一連のワークフローを自動実行します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/newkayak12/claude-skills/tree/HEAD/portfolio/skills/deck-builder

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

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

ドキュメント

このスキルの機能

デッキをドキュメントではなくビルドとして扱います:

アーティファクト役割
template.pptxツールチェーン — そのスライドがアーキタイプカタログです。常に必須。
deck.mdxソース — 誰もが編集する唯一のファイル
assets/*.svg生成されたアート。ソースでもあり、コンテンツのみ、デザインはなし
deck.pptxビルドアーティファクト — 毎回完全に再生成されます
deck.pdf + ページプレビュー人間が実際に見るもの — レイアウトが存在する唯一の場所

各出力スライドは、テンプレートスライドのクローンであり、そのコンテンツが入れ替えられるため、テンプレートのデザインはバイト単位でそのまま残ります。何もゼロからレイアウトされることはありません。

エンジン: scripts/deck.py (絶対パスで呼び出します)。

色変更 (任意のpptx。ビルド済みデッキの場合は template.pptx を色変更してリビルド): scripts/ppt_keycolor_changer.py、 手順とプリセットは references/recolor.md にあります — 検出、明度によるマッピング、確認、置換、検証。

常設の指示

  • 参照テンプレートなしでビルドしてはいけません。 組み込みのデッキデザインやフォールバックはありません。ユーザーが .pptx を提供していない場合は、停止してそれを要求してください — 他の方法でスライドを組み立てたり、汎用的なデッキを提供したり、テンプレートをでっち上げたりしないでください。エンジンも拒否しますが、要求はユーザーが作業を始める前にあなたが行うべきものです。
  • ソースファイルは deck.mdx であり、決して deck.md ではありません。 これはコンパイルされるものであり、読み取られるものではありません。エンジンは他の拡張子を拒否します。
  • カタログを先に、作成は後。 テンプレートについての推測から deck.mdx を作成してはいけません。catalog を実行し、それが出力するスロットIDに対して作成してください。
  • 出力されたpptxを手動で編集してはいけません。 次回のビルドで再生成されます。修正は deck.mdx に行ってください。
  • build の前に check を実行し、ユーザーに警告を表示してください。 オーバーフロー警告は、詰め込まれたテキストと誰も読めないスライドの違いを生み出します。
  • 決定基準は見やすさであり、すっきり感ではありません。 | transparent は、画像の内容がスライドに対して読みやすいままである場合に適しています。check はそれができない場合を報告し、その場合は画像の後ろにパネルを配置する方が良い解決策です。すっきり聞こえるからといって透過性に頼らないでください。
  • 断りなしにコンテンツを切り取ってはいけません。 check は割合を報告します。それをユーザーに伝え、| fit を提案してください。半分が失われる画像は、スライドから落ちるテーブル行と同じ欠陥です。
  • 画像スロットのアートをバイナリとして手動で作成してはいけません。 SVGを記述することで、デッキがテキストから再現可能な状態を保てます。貼り付けられたPNGは、再生成、色変更、差分レビューができません。
  • デッキは人が読むものなので、実際に見てください。 レンダラーが利用可能な場合は、build ではなく render で終了してください。レイアウト監査とページプレビューだけが、テキストの衝突を確認できる場所です。レンダラーが利用できない場合は、レイアウトがチェックされたと暗示するのではなく、レポートにその旨を明確に記載してください。
  • アーキタイプをでっち上げてはいけません。 コンテンツに適合するテンプレートスライドがない場合は、その旨を伝え、コンテンツを再構成するかテンプレートを拡張するかを尋ねてください — 近似してはいけません。
  • 無視することを選択した警告も報告してください。 問題ないと判断したオーバーフロー警告でも、最終報告書に含めるべきです — そのスライドを見るのはユーザーです。
  • チャートは読み取り専用です。 選択したアーキタイプにチャートがある場合は、これを声に出して伝えてください。ユーザーがPowerPointでチャートを編集しない限り、テンプレートの数値がそのまま出力されます。

プロセス

ステップ0 · 参照テンプレートを入手する

まだ持っていない場合は、何よりも先に .pptx を要求してください:

「レファレンステンプレートのpptxをください。deck-builderはテンプレートスライドを複製する方式なので、テンプレートなしでは作れるスライドがありません。」

テンプレートの説明、類似したデッキ、後で提供するという約束だけで先に進まないでください。

ステップ1 · テンプレートをカタログ化する

python3 /abs/path/scripts/deck.py catalog \
  --template "template.pptx" --output "deck.catalog.md"

すべてのアーキタイプを @s1…@sN として、そのスロット、テンプレートが現在表示しているもの、および容量見積もりとともに出力します。何よりも先にこれを読んでください。

ステップ2 · コンテンツをアーキタイプにマッピングする

コンテンツがない場合は、ユーザーに依頼してください。次に、mdを記述する前に、スライドごとに1行の計画を示してください:

1. @s1  表紙            — タイトル + サブタイトル
2. @s3  要約            — 箇条書き3つ + 一行の結論
3. @s7  数字            — 表4行

計画について了承を得てください。誤ったアーキタイプの選択は、間違った文言よりも高くつくミスです。

ステップ3 · deck.mdx を記述する

---
template: template.pptx
template_hash: 5f84440a3521      # カタログから — デッキをテンプレートの構造に固定します
output: deck.pptx
---

## @s3
title: 四半期サマリー
text1:
  - 応答 p99 **2.1s → 340ms**
  - デプロイ失敗率 12% → 0.4%
table1:
  | 指標 | 以前 | 以降 |
  | p99 | 2.1s | 340ms |
pic1: assets/arch.svg
notes: 数字の出典を最初に述べること
text5: !drop

画像はフィットモードを取ります — | fit は画像全体を保持し、デフォルトの fill はクロップします — | transparent はPNGの背景を透過します。省略したスロットはテンプレートのコンテンツを保持します。

完全な構文 — スロット形式、!drop、notes:、インライン強調、アウトラインレベル、 および template_hash が保護するもの — は references/mdx-syntax.md にあります。最初のスライドを記述する前に読んでください。

ステップ3b · デッキに必要なアートを生成する

画像スロットのアートは .svg として、テンプレートの色とフレームの正確なptサイズで記述してください — どちらも catalog によって出力されます。これはデッキの他の部分と同様にソースとなり、ビルド時にPNGにラスタライズされます。

ルール、根拠、および実例: references/generated-art.md。

ステップ4 · チェック

python3 /abs/path/scripts/deck.py check --deck deck.mdx

エラーは修正する必要があります。警告は判断が必要です — 無視することを決めたものを含め、すべての警告を表面化させてください。

測定内容比較対象
テーブルまたはテキストがスライドからはみ出しているスライドの端 — エラー、失われた行を特定
テンプレートが1行に収めているスロットに対してラインが広すぎるそのスロット自身のフレーム (em単位)。ハングルがラテン文字としてカウントされないように
スロットがテンプレートの配置よりもはるかに少ない量を保持しているテンプレート自身のボリューム — フレームはその量のために描かれており、スライドは穴を開ける
テキストがデザインの想定位置よりも低く実行されているテンプレート自身の行数とその下にあるもの
クロップロス、実効dpi、パレットからの逸脱、貼り付けボックスの境界線フレーム、スクリーン、テンプレートのパレット
画像上のテキスト実際に背後にあるピクセル: 大きなタイプでは3:1、本文では4.5:1

カバーする単語の後に描画された画像はエラーです — それらはイメージの背後に配置されます。

ここでのすべての見積もりは、絶対値ではなくテンプレート自身のコンテンツに対して較正されています。なぜなら、ほとんどのフレームは既に折り返されるテキストを保持するように描かれているからです。約1行未満のマージンは、静的見積もりで解決できる範囲を超えています: これらを解決できるのはステップ6だけです。

ステップ5 · ビルド

python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]

同じ deck.mdx は常にバイト単位で同一のpptxを生成します。

ステップ6 · レンダリングして確認

python3 /abs/path/scripts/deck.py render --deck deck.mdx

ビルドし、LibreOfficeを通じて変換し、すべてのページのPNGプレビューを書き込み、レンダリングされたジオメトリを監査します — overlap (2つのテキストフレームが衝突)、bunched (1つのフレーム内の行がそのフレーム自身の標準よりも近くに配置されているため、テキストがボックスを超えて成長している)、off-slide (レンダラーがそれをカットした)。クリーンはクリーンを意味します: 監査はフレーム間で比較し、各フレームの中央値に対してピッチを測定するため、emボックスが100%行を超えるCJKフォントがトリップすることはありません。

render は最初に、レンダラーが持っていないテンプレートの書体を報告します。置き換えられたフォントはすべての行をリラップするため、それらがインストールされるまでは、プレビューの改行はデッキのものではなく、置き換えられたフォントのものになります — 修正方法はフォントをインストールすることであり、単語を短くすることではありません。pptx自体は常に正しいフォントを指定します。

プレビューはレイアウトのために読み、スペーシングのために読まないでください。LibreOfficeはデフォルトでCJKとラテン文字の間の結合をパディングするため、평균 42분 はプレビューでは 평균 42 분 とレンダリングされますが、pptxは元の文字列を保持します。スペーシングを欠陥として扱う前に、ビルドされたファイル内の <a:t> を確認してください。

レンダラーはPATH上の soffice または DECK_RENDER_DOCKER=<image> です。どちらもない場合、render はレイアウトがチェックされたふりをするのではなく拒否します — その旨を伝え、build にフォールバックしてください。

出力テンプレート

ビルド後のレポート:

ビルド完了 — <出力パス>
  スライド <N>個 · テンプレート <名前> · 画像 <M>個挿入
  レンダリング検査 — 重なり 0件 (または: 3ページのタイトルが本文と重なっています)

使用したアーキタイプ
  @s1 ×1  表紙
  @s3 ×4  本文

確認が必要
  · 3番スライド title 58文字 (フレーム ~39文字/行) — 2行にまたがります
  · 5番スライド chart1 — チャート数値はテンプレート値のままです

次の修正は deck.mdx だけを修正して再度 build してください。出力pptxを手で觸ると失われます。

Claudeの役割 / あなたの役割

Claudeあなた
参照pptxを要求し、なしでは先に進むことを拒否するテンプレート(必須)と生のコンテンツを提供する
catalog を実行し、スロットマップを読むアーキタイプリストをレビューする
スライドごとのアーキタイプ計画を提案する計画を承認するか、再構成する
deck.mdx を記述し、修正する好みに応じて直接 deck.mdx を編集する
check を実行し、すべての警告を報告するオーバーフロー警告が重要かどうかを判断する
render を実行し、プレビューを見て、衝突を報告するpptxを開き、必要に応じてチャートを編集する

制限事項

約束できることを変更する6つの制限:

制限結果
新しいレイアウトはなしすべてのスライドはクローンです。アーキタイプがないコンテンツは、PowerPointでテンプレートを拡張する必要があります — 近似するのではなく、その旨を伝えてください。
テンプレートは必須組み込みデザインやフォールバックはありません。
チャートは書き込み不可build はテンプレートの数値を残します。画像スロットにSVGを使用してください。
フレームは決して移動しない短く書いても隙間は残ります。check がそれを報告しますが、閉じることができるのはテンプレートだけです。
レイアウトの真実にはレンダラーが必要check は見積もりであり、1行未満のマージンを解決できません。何が衝突するかを確認できるのは render だけです。
可読性はPNGのみJPEGやSVGの背景の上のタイプはスコアリングされません。継承されたテキストの色はそのまま残されます。

完全な表と、各制限がどのステップで捕捉されるか: references/limits.md。

関連スキル

  • write:plans (ドキュメントの目的) — コンテンツをスライドにマッピングする前に開発する
  • think:untangle-thoughts — 散らばったメモをステップ2が必要とするスライド単位の構造に変換する

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

newkayak12/claude-skills

>- Use when someone explicitly asks for beta portfolio feedback: feedback plus writing patterns (피동, team subject, number density, decision visibility). Triggers only on "피드백 베타로", "feedback beta".

newkayak12/claude-skills

>- Use when someone shares a developer portfolio and wants interviewer-grade feedback: screen verdict, whether numbers and skills hold up, whether it reads at the claimed level. Triggers: "포트폴리오 피드백 해줘", "서류 통과할까", "숫자 근거 있어?", "시니어로 읽혀?", "고친 버전 비교".

newkayak12/claude-skills

>- Use when judging a portfolio's fit to a JD, or with no JD to company types or a named company. Triggers: "이 공고에 맞아?", "JD랑 비교해줘", "어느 회사에 잘 맞아?", "네이버 지원하려는데 어때?", "which companies fit me". Not generic "서류 통과할까?" (feedback).

newkayak12/claude-skills

>- Use when someone needs an interview preparation plan before their interview process begins — a study schedule, gap analysis by topic area, and STAR story prompts. This is planning, not practice. Triggers on: "interview prep plan", "면접 준비 계획".

newkayak12/claude-skills

>- Use when preparing a job application or career transition end-to-end, from JD fit through 자기소개서 to mock interview. Triggers on: "job application workflow", "이직 준비 전체", "취업 프로세스 시작", "career transition", "job search process".

newkayak12/claude-skills

>- Use when someone wants a realistic mock interview grounded in their own portfolio, with per-answer coaching. Triggers on: "모의 면접 해줘", "인터뷰 연습", "mock interview", "grill me on my portfolio".

newkayak12/claude-skills

>- Use when someone wants to understand the writing patterns in their portfolio — not what it says but how it reads: passive voice ratio, subject audit, number density, and decision visibility. Triggers on: "패턴 분석해줘", "오너십이 잘 드러나나", "피동형 많이 썼나".

newkayak12/claude-skills

>- Use when resume or portfolio lines need a stronger rewrite, optionally to a JD. Triggers: "이 문장 고쳐줘", "이 부분 어떻게 쓰면 좋아", "더 잘 쓰는 법", "임팩트 있게 바꿔줘", "rewrite this portfolio section", "이력서 맞춰줘", "공고에 맞게 고쳐줘", "이력서 최적화", "tailor my resume to this JD".

関連スキル