Communitygithub.com

newkayak12/claude-skills

Erstellt Folien aus Inhalten, nicht durch manuelle Bearbeitung: Vorlage lesen, Deck als Markdown schreiben, rendern. Auslöser: PPT 만들어줘, 템플릿에 내용 채워줘, 발표자료 생성, md로 PPT 만들기, deck from markdown, PPT 키컬러 변경, 브랜드 컬러로 교체, recolor pptx.

Was ist claude-skills?

Diese Fähigkeit behandelt eine Präsentation (Deck) als Build-Prozess, nicht als Dokument. Der Workflow basiert auf einer PowerPoint-Vorlage (`template.pptx`), die als Archetyp-Katalog dient, und einer einzigen Quelldatei (`deck.mdx`), die den Inhalt als Markdown definiert. Jede Ausgabefolie ist ein Klon einer Vorlagenfolie – das Design der Vorlage bleibt Byte für Byte erhalten. Die Fähigkeit unterstützt die Erstellung von Folien aus Markdown, das Neukolorieren von Präsentationen mit einem Skript (`ppt_keycolor_changer.py`) und umfasst Prüfungen auf Überlauf, Überlappungen und fehlende Schriftarten. Plattformen sind Claude Code, Cursor und andere KI-Agenten, die Python-Skripte ausführen können. Der Prozess erfordert zwingend eine Vorlage, eine Katalogisierung aller Folien-Platzhalter, ein explizites Mapping des Inhalts auf Archetypen, die Generierung von SVG-Grafiken, eine Build-Prüfung und abschließendes Rendern zur visuellen Validierung. Die Fähigkeit betont, dass Layouts nicht neu erfunden werden und dass der Benutzer bei fehlender Vorlage, überfließendem Text oder fehlenden Schriftarten gewarnt wird.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was diese Fähigkeit tut

Behandelt eine Präsentation (Deck) als Build, nicht als Dokument:

ArtefaktRolle
template.pptxDie Werkzeugkette – ihre Folien sind der Archetyp-Katalog. Immer erforderlich.
deck.mdxDie Quelle – die einzige Datei, die jemand bearbeitet
assets/*.svgGenerierte Grafiken, ebenfalls Quelle – nur Inhalt, kein Design
deck.pptxDas Build-Artefakt – wird jedes Mal vollständig neu generiert
deck.pdf + SeitenvorschauenDas, was eine Person tatsächlich ansieht – der einzige Ort, an dem Layout sichtbar ist

Jede Ausgabefolie ist ein Klon einer Vorlagenfolie mit ausgetauschtem Inhalt, sodass das Design der Vorlage Byte für Byte erhalten bleibt. Es wird nichts von Grund auf neu angelegt.

Engine: scripts/deck.py (mit absolutem Pfad aufrufen).

Neukolorierung (jede pptx; für ein gebautes Deck template.pptx neu kolorieren und neu bauen): scripts/ppt_keycolor_changer.py, Verfahren und Voreinstellungen in references/recolor.md – entdecken, nach Helligkeit zuordnen, bestätigen, ersetzen, überprüfen.

Ständige Vorgaben

  • Niemals ohne Referenzvorlage bauen. Es gibt kein eingebautes Deck-Design und keinen Fallback. Wenn der Benutzer Ihnen keine .pptx gegeben hat, halten Sie an und fragen Sie danach – stellen Sie keine Folien auf andere Weise zusammen, bieten Sie kein generisches Deck an und erfinden Sie keine Vorlage. Die Engine lehnt dies ebenfalls ab, aber die Aufforderung liegt bei Ihnen, bevor irgendeine Arbeit beginnt.
  • Die Quelldatei ist deck.mdx, niemals deck.md. Sie wird kompiliert, nicht gelesen. Die Engine lehnt jede andere Erweiterung ab.
  • Vor dem Schreiben katalogisieren. Verfassen Sie deck.mdx niemals aufgrund einer Vermutung über die Vorlage. Führen Sie catalog aus und schreiben Sie gegen die Slot-IDs, die es ausgibt.
  • Die Ausgabe-pptx niemals von Hand bearbeiten. Sie wird beim nächsten Build neu generiert. Korrekturen gehen in deck.mdx.
  • Führen Sie check vor build aus und zeigen Sie dem Benutzer die Warnungen. Überlaufwarnungen sind das, was zwischen überfülltem Text und einer Folie, die niemand lesen kann, steht.
  • Sichtbarkeit entscheidet, nicht Ordentlichkeit. | transparent ist richtig, wenn der Inhalt des Bildes gegen die Folie lesbar bleibt; check sagt, wann dies nicht der Fall ist, und ein Panel hinter dem Bild ist dort die bessere Antwort. Greifen Sie nicht zu Transparenz, weil es sauberer klingt.
  • Niemals Inhalte wegschneiden, ohne es zu sagen. check meldet den Prozentsatz; wiederholen Sie ihn dem Benutzer und bieten Sie | fit an. Ein Bild, das die Hälfte von sich selbst verliert, ist derselbe Fehler wie eine Tabellenzeile, die von der Folie fällt.
  • Niemals die Grafik eines Bild-Slots von Hand als Binärdatei erstellen. Schreiben Sie das SVG, damit das Deck aus Text reproduzierbar bleibt. Ein PNG, das jemand eingefügt hat, kann nicht neu generiert, neu koloriert oder in einem Diff überprüft werden.
  • Ein Deck wird von Menschen gelesen, also sehen Sie es sich an. Wenn ein Renderer verfügbar ist, beenden Sie mit render, nicht mit build – das Layout-Audit und die Seitenvorschauen sind der einzige Ort, an dem Textkollisionen sichtbar werden. Wenn kein Renderer verfügbar ist, sagen Sie dies im Bericht klar, anstatt zu implizieren, dass das Layout geprüft wurde.
  • Niemals einen Archetyp erfinden. Wenn keine Vorlagenfolie zum Inhalt passt, sagen Sie dies und fragen Sie, ob der Inhalt umgeformt oder die Vorlage erweitert werden soll – nähern Sie sich nicht an.
  • Melden Sie die Warnungen, die Sie ignoriert haben. Eine Überlaufwarnung, die Sie für in Ordnung hielten, gehört trotzdem in den Abschlussbericht – der Benutzer wird die Folie sehen.
  • Diagramme sind schreibgeschützt. Sagen Sie dies laut, wenn der gewählte Archetyp eines hat; die Zahlen der Vorlage werden übernommen, es sei denn, der Benutzer bearbeitet das Diagramm in PowerPoint.

Prozess

Schritt 0 · Referenzvorlage besorgen

Fragen Sie nach der .pptx, bevor Sie irgendetwas anderes tun, wenn Sie keine haben:

"Bitte geben Sie die Referenzvorlage als pptx. Der Deck-Builder funktioniert durch Klonen von Vorlagenfolien; ohne Vorlage gibt es keine Folien, die erstellt werden können."

Fahren Sie nicht mit einer Beschreibung einer Vorlage, einem ähnlich aussehenden Deck oder dem Versprechen, eine später zu liefern, fort.

Schritt 1 · Vorlage katalogisieren

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

Gibt jeden Archetyp als @s1…@sN mit seinen Slots, dem aktuellen Inhalt der Vorlage und einer Kapazitätsschätzung aus. Lesen Sie es vor allem anderen.

Schritt 2 · Inhalt auf Archetypen abbilden

Fragen Sie den Benutzer nach dem Inhalt, wenn Sie ihn nicht haben. Zeigen Sie dann, bevor Sie md schreiben, einen Einzeiler-pro-Folie-Plan:

1. @s1  Deckblatt        – Titel + Untertitel
2. @s3  Zusammenfassung  – 3 Aufzählungspunkte + einzeiliges Fazit
3. @s7  Zahlen           – Tabelle 4 Zeilen

Holen Sie sich Zustimmung zum Plan. Die falsche Archetyp-Wahl ist der teure Fehler, nicht die falsche Formulierung.

Schritt 3 · deck.mdx schreiben

---
template: template.pptx
template_hash: 5f84440a3521      # aus dem Katalog – verknüpft das Deck mit der Vorlagenstruktur
output: deck.pptx
---

## @s3
title: Quartalszusammenfassung
text1:
  - Antwortzeit p99 **2,1s → 340ms**
  - Bereitstellungsfehlerrate 12% → 0,4%
table1:
  | Metrik | Vorher | Nachher |
  | p99 | 2,1s | 340ms |
pic1: assets/arch.svg
notes: Zuerst die Quellen der Zahlen nennen
text5: !drop

Bilder benötigen einen Anpassungsmodus – | fit behält das gesamte Bild, der Standard fill beschneidet es – und | transparent entfernt den Hintergrund eines PNG. Ausgelassene Slots behalten den Inhalt der Vorlage.

Die vollständige Syntax – Slot-Formen, !drop, notes:, Inline-Hervorhebung, Gliederungsebenen und wogegen template_hash schützt – befindet sich in references/mdx-syntax.md. Lesen Sie es, bevor Sie die erste Folie schreiben.

Schritt 3b · Erstellen Sie die benötigten Grafiken

Schreiben Sie die Grafik eines Bild-Slots als .svg in den Farben der Vorlage und in der exakten Punktgröße des Rahmens – beide werden von catalog ausgegeben. Es wird wie der Rest des Decks zur Quelle und zur Build-Zeit in PNG gerastert.

Regeln, Begründung und ein durchgearbeitetes Beispiel: references/generated-art.md.

Schritt 4 · Prüfen

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

Fehler müssen behoben werden. Warnungen sind Ermessensentscheidungen – zeigen Sie jede einzelne an, einschließlich derer, die Sie zu ignorieren beschließen.

Was gemessen wirdGegen
Eine Tabelle oder Text läuft von der Foliedem Folienrand – ein Fehler, der die verlorenen Zeilen benennt
Eine Zeile ist zu breit für einen Slot, den die Vorlage einzeilig hältdem eigenen Rahmen des Slots in em, sodass Hangul nicht wie Latein gezählt wird
Ein Slot fasst weit weniger als die Vorlage dort platziertdem eigenen Volumen der Vorlage – der Rahmen wurde für diese Menge gezeichnet und die Folie öffnet ein Loch
Text reicht tiefer als vom Design vorgesehender eigenen Zeilenanzahl der Vorlage und dem, was darunter sitzt
Beschnittverlust, effektive dpi, Palettenabweichungen, eingefügte Box-Ränderdem Rahmen, dem Bildschirm und der Palette der Vorlage
Text über einem Bildden Pixeln tatsächlich dahinter: 3:1 für große Schrift, 4,5:1 für Fließtext

Ein Bild, das nach den Wörtern gezeichnet wird, die es bedeckt, ist ein Fehler – sie landen hinter dem Bild.

Jede Schätzung hier ist an den eigenen Inhalt der Vorlage kalibriert und nicht an einem absoluten Wert, da die meisten Rahmen gezeichnet sind, um Text zu halten, der bereits umbricht. Ränder unter etwa einer Zeile liegen jenseits dessen, was eine statische Schätzung auflösen kann: Nur Schritt 6 klärt diese.

Schritt 5 · Bauen

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

Dasselbe deck.mdx erzeugt immer eine byte-identische pptx.

Schritt 6 · Rendern und ansehen

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

Baut, konvertiert über LibreOffice, schreibt PNG-Vorschauen jeder Seite und prüft die gerenderte Geometrie – overlap (zwei Textrahmen kollidieren), bunched (Zeilen in einem Rahmen sitzen enger als die Norm dieses Rahmens, sodass der Text seinen Kasten überwachsen hat), off-slide (der Renderer hat ihn abgeschnitten). Sauber bedeutet sauber: Das Audit vergleicht zwischen Rahmen und misst den Zeilenabstand gegen den Median jedes Rahmens, sodass CJK-Schriftarten, deren em-Box eine 100%-Zeile überschreitet, es nicht auslösen.

render sagt zuerst, welche der Schriftarten der Vorlage der Renderer nicht hat. Eine ersetzte Schriftart bricht jede Zeile neu um, sodass die Zeilenumbrüche der Vorschau bis zur Installation dieser Schriftarten die des Ersatzes sind, nicht die des Decks – die Lösung ist, die Schriftart zu installieren, nicht die Wörter zu kürzen. Die pptx selbst benennt immer die richtigen Schriftarten.

Lesen Sie die Vorschauen für das Layout, nicht für den Abstand. LibreOffice entfernt standardmäßig den Abstand zwischen CJK und Latein, sodass 평균 42분 in der Vorschau als 평균 42 분 gerendert wird, während die pptx den ursprünglichen String enthält. Überprüfen Sie <a:t> in der erstellten Datei, bevor Sie Abstand als Fehler behandeln.

Renderer ist soffice im PATH oder DECK_RENDER_DOCKER=<image>. Wenn keines vorhanden ist, verweigert render den Dienst, anstatt so zu tun, als ob das Layout geprüft wurde – sagen Sie dies und fallen Sie auf build zurück.

Ausgabevorlage

Bericht nach einem Build:

Build abgeschlossen – <Ausgabepfad>
  Folien <N> · Vorlage <Name> · Bilder <M> eingefügt
  Render-Prüfung – Überlappungen 0 (oder: Seite 3 Titel überlappt mit Textkörper)

Verwendete Archetypen
  @s1 ×1  Deckblatt
  @s3 ×4  Textkörper

Zu prüfen
  · Folie 3 title 58 Zeichen (Rahmen ~39 Zeichen/Zeile) – geht auf zwei Zeilen über
  · Folie 5 chart1 – Diagrammwerte sind die der Vorlage

Für die nächste Änderung nur deck.mdx bearbeiten und erneut build ausführen. Die Ausgabe-pptx wird bei manueller Bearbeitung überschrieben.

Was Claude tut / Was Sie tun

ClaudeSie
Fragt nach der Referenz-pptx, weigert sich, ohne diese fortzufahrenStellt die Vorlage – obligatorisch – und den rohen Inhalt bereit
Führt catalog aus, liest die Slot-KarteÜberprüft die Archetyp-Liste
Schlägt den Archetyp-pro-Folie-Plan vorGenehmigt oder ordnet den Plan neu an
Schreibt und überarbeitet deck.mdxBearbeitet deck.mdx direkt, wann immer Sie bevorzugen
Führt check aus, meldet jede WarnungEntscheidet, ob eine Überlaufwarnung relevant ist
Führt render aus, sieht sich die Vorschauen an, meldet KollisionenÖffnet die pptx, bearbeitet Diagramme bei Bedarf

Einschränkungen

Die sechs, die ändern, was Sie versprechen können:

EinschränkungKonsequenz
Keine neuen LayoutsJede Folie ist ein Klon. Inhalt ohne Archetyp erfordert eine Erweiterung der Vorlage in PowerPoint – sagen Sie dies, anstatt zu approximieren.
Eine Vorlage ist zwingendKein eingebautes Design, kein Fallback.
Diagramme sind nicht beschreibbarbuild belässt die Zahlen der Vorlage. Verwenden Sie ein SVG in einem Bild-Slot.
Rahmen bewegen sich nieSchreiben Sie kurz und der Abstand bleibt; check meldet es, nur die Vorlage kann ihn schließen.
Layout-Wahrheit benötigt einen Renderercheck schätzt und kann Ränder unter einer Zeile nicht auflösen. Nur render sieht, was kollidiert.
Lesbarkeit ist nur PNGText über einem JPEG- oder SVG-Hintergrund wird nicht bewertet; geerbte Textfarben bleiben unberührt.

Vollständige Tabelle und welcher Schritt welche Einschränkung abfängt: references/limits.md.

Verwandte Fähigkeiten

  • write:plans (Dokumentzweck) – Inhalt entwickeln, bevor er auf Folien abgebildet wird
  • think:untangle-thoughts – verstreute Notizen in die Folie-für-Folie-Struktur von Schritt 2 verwandeln

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".

Verwandte Skills