Communitygithub.com

newkayak12/claude-skills

Utilisé lorsqu'un PPTX doit être construit à partir du contenu plutôt que saisi diapositive par diapositive — lire un modèle, écrire le deck en markdown, générer. Déclencheurs : PPT 만들어줘, 템플릿에 내용 채워줘, 발표자료 생성, md로 PPT 만들기, deck from markdown, PPT 키컬러 변경, 브랜드 컬러로 교체, recolor pptx.

Qu'est-ce que claude-skills ?

Ce skill transforme la création de présentations PowerPoint en un processus de build reproductible, où le contenu est rédigé en Markdown et le design provient intégralement d'un modèle de référence. Il prend en charge les plateformes Claude Code et autres agents compatibles avec les skills, en utilisant un moteur Python (scripts/deck.py) pour cataloguer les archétypes de diapositives, vérifier les débordements de texte, et régénérer le fichier PPTX à chaque build. L'utilisateur fournit un modèle PPTX obligatoire et écrit le contenu dans un fichier deck.mdx, tandis que l'agent exécute les étapes de catalogage, vérification, build et rendu. Le skill inclut également un outil de recoloration (scripts/ppt_keycolor_changer.py) pour appliquer une palette de couleurs cohérente. Ses limitations principales sont l'absence de nouveaux designs (chaque diapositive clone un modèle), l'obligation d'un modèle, et l'impossibilité de modifier les graphiques directement.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Ce que fait ce skill

Considère un deck comme une construction, pas un document :

ArtefactRôle
template.pptxla chaîne d'outils — ses diapositives sont le catalogue d'archétypes. Toujours requis.
deck.mdxla source — le seul fichier que quiconque édite
assets/*.svgl'art généré, également source — contenu uniquement, pas de design
deck.pptxl'artefact de construction — régénéré entièrement à chaque fois
deck.pdf + aperçus de pagesce qu'une personne regarde vraiment — le seul endroit où la mise en page apparaît

Chaque diapositive de sortie est un clone d'une diapositive du modèle avec son contenu échangé, donc le design du modèle survit octet par octet. Rien n'est mis en page à partir de zéro.

Moteur : scripts/deck.py (invoquer avec un chemin absolu).

Recoloration (n'importe quel pptx ; pour un deck construit, recolorer template.pptx et reconstruire) : scripts/ppt_keycolor_changer.py, procédure et préréglages dans references/recolor.md — découvrir, mapper par luminosité, confirmer, remplacer, vérifier.

Directives permanentes

  • Ne jamais construire sans modèle de référence. Il n'y a pas de design de deck intégré ni de solution de repli. Si l'utilisateur ne vous a pas donné de .pptx, arrêtez-vous et demandez-en un — n'assemblez pas les diapositives d'une autre manière, ne proposez pas de deck générique, ne fabriquez pas de modèle. Le moteur le refuse aussi, mais la demande vous appartient, avant tout travail.
  • Le fichier source est deck.mdx, jamais deck.md. Il est compilé, pas lu. Le moteur rejette toute autre extension.
  • Cataloguer avant d'écrire. Ne rédigez jamais deck.mdx à partir d'une supposition sur le modèle. Exécutez catalog et écrivez en fonction des identifiants d'emplacement qu'il affiche.
  • Ne jamais modifier manuellement le pptx de sortie. Il est régénéré lors de la prochaine construction. Les corrections vont dans deck.mdx.
  • Exécutez check avant build, et montrez les avertissements à l'utilisateur. Les avertissements de débordement sont ce qui sépare un texte surchargé d'une diapositive que personne ne peut lire.
  • La visibilité décide, pas la propreté. | transparent est correct lorsque le contenu de l'image reste lisible sur la diapositive ; check indique quand ce n'est pas le cas, et un panneau derrière l'image est la meilleure réponse dans ce cas. Ne cherchez pas la transparence parce que cela semble plus propre.
  • Ne jamais rogner le contenu sans le dire. check signale le pourcentage ; répétez-le à l'utilisateur et proposez | fit. Une image qui perd la moitié d'elle-même est le même défaut qu'une ligne de tableau qui tombe de la diapositive.
  • Ne jamais écrire manuellement l'art d'un emplacement d'image en binaire. Écrivez le SVG pour que le deck reste reproductible à partir du texte. Un PNG collé par quelqu'un ne peut pas être régénéré, recoloré, ou examiné dans un diff.
  • Un deck est lu par des personnes, donc regardez-le. Lorsqu'un moteur de rendu est disponible, terminez par render, pas build — la vérification de la mise en page et les aperçus de pages sont le seul endroit où les collisions de texte apparaissent. Si aucun moteur de rendu n'est disponible, dites-le clairement dans le rapport au lieu d'impliquer que la mise en page a été vérifiée.
  • Ne jamais inventer un archétype. Si aucune diapositive du modèle ne correspond au contenu, dites-le et demandez si vous devez remodeler le contenu ou étendre le modèle — n'approximativez pas.
  • Signalez les avertissements que vous avez choisi d'ignorer. Un avertissement de débordement que vous avez jugé acceptable fait toujours partie du rapport final — c'est l'utilisateur qui verra la diapositive.
  • Les graphiques sont en lecture seule. Dites-le clairement lorsque l'archétype choisi en contient un ; les chiffres du modèle sont fournis à moins que l'utilisateur ne modifie le graphique dans PowerPoint.

Processus

Étape 0 · Obtenir le modèle de référence

Demandez le .pptx avant toute autre chose si vous n'en avez pas :

"레퍼런스 템플릿 pptx를 주세요. deck-builder는 템플릿 슬라이드를 복제하는 방식이라, 템플릿 없이는 만들 수 있는 슬라이드가 없습니다."

Ne continuez pas sur la base d'une description d'un modèle, d'un deck d'apparence similaire, ou d'une promesse d'en fournir un plus tard.

Étape 1 · Cataloguer le modèle

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

Affiche chaque archétype sous forme de @s1…@sN avec ses emplacements, ce que le modèle montre actuellement, et une estimation de capacité. Lisez-le avant toute autre chose.

Étape 2 · Mapper le contenu sur les archétypes

Demandez le contenu à l'utilisateur si vous ne l'avez pas. Ensuite, avant d'écrire du md, montrez un plan d'une ligne par diapositive :

1. @s1  표지            — 제목 + 부제
2. @s3  요약            — 불릿 3개 + 한 줄 결론
3. @s7  숫자            — 표 4행

Obtenez un accord sur le plan. Un mauvais choix d'archétype est l'erreur coûteuse, pas un mauvais libellé.

Étape 3 · Écrire deck.mdx

---
template: template.pptx
template_hash: 5f84440a3521      # du catalogue — ancre le deck à la structure du modèle
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

Les images acceptent un mode d'ajustement — | fit conserve l'image entière, le défaut fill la rogne — et | transparent supprime l'arrière-plan d'un PNG. Les emplacements que vous omettez conservent le contenu du modèle.

La syntaxe complète — formes des emplacements, !drop, notes:, emphase en ligne, niveaux de plan, et ce que template_hash protège — se trouve dans references/mdx-syntax.md. Lisez-la avant d'écrire la première diapositive.

Étape 3b · Générer l'art nécessaire au deck

Écrivez l'art d'un emplacement d'image en .svg, dans les couleurs du modèle et à la taille en points exacte du cadre — toutes deux imprimées par catalog. Il devient une source comme le reste du deck et est pixellisé en PNG lors de la construction.

Règles, justification et exemple concret : references/generated-art.md.

Étape 4 · Vérifier

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

Les erreurs doivent être corrigées. Les avertissements sont des jugements à prendre — exposez chacun d'eux, y compris ceux que vous décidez d'ignorer.

Ce qu'il mesurePar rapport à
Un tableau ou du texte qui dépasse de la diapositivele bord de la diapositive — une erreur, nommant les lignes perdues
Une ligne trop large pour un emplacement que le modèle maintient sur une seule lignele cadre de cet emplacement, en em, de sorte que le hangul n'est pas compté comme du latin
Un emplacement contenant beaucoup moins que ce que le modèle y placele volume propre du modèle — le cadre a été dessiné pour cela et la diapositive ouvre un trou
Du texte qui descend plus bas que le design ne le placele propre nombre de lignes du modèle et ce qui se trouve en dessous
Perte de recadrage, dpi effectif, écarts de palette, bordures d'images colléesle cadre, l'écran et la palette du modèle
Texte sur une imageles pixels réellement derrière : 3:1 pour les grands caractères, 4.5:1 pour le corps

Une image dessinée après les mots qu'elle recouvre est une erreur — ils finissent derrière l'image.

Chaque estimation ici est calibrée par rapport au propre contenu du modèle plutôt qu'à une valeur absolue, car la plupart des cadres sont dessinés pour contenir du texte qui se coupe déjà. Les marges inférieures à environ une ligne sont au-delà de ce qu'une estimation statique peut résoudre : seule l'Étape 6 les règle.

Étape 5 · Construire

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

Le même deck.mdx produit toujours un pptx octet pour octet identique.

Étape 6 · Rendre et regarder

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

Construit, convertit via LibreOffice, écrit des aperçus PNG de chaque page, et vérifie la géométrie rendue — overlap (deux cadres de texte se chevauchent), bunched (les lignes à l'intérieur d'un cadre sont plus proches que la norme de ce cadre, donc le texte a dépassé sa boîte), off-slide (le moteur de rendu l'a coupé). Propre signifie propre : la vérification compare entre les cadres et mesure l'interlignage par rapport à la médiane de chaque cadre, donc les polices CJK dont la boîte em dépasse une ligne à 100% ne la font pas échouer.

render indique d'abord quelles polices du modèle le moteur de rendu ne possède pas. Une police substituée refait chaque ligne, donc tant qu'elles ne sont pas installées, les sauts de ligne de l'aperçu sont ceux de la police de substitution, pas du deck — la solution est d'installer la police, pas de raccourcir les mots. Le pptx lui-même nomme toujours les bonnes polices.

Lisez les aperçus pour la mise en page, pas pour l'espacement. LibreOffice rembourre la jonction entre CJK et latin par défaut, donc 평균 42분 s'affiche comme 평균 42 분 dans l'aperçu tandis que le pptx contient la chaîne originale. Vérifiez <a:t> dans le fichier construit avant de traiter l'espacement comme un défaut.

Le moteur de rendu est soffice dans le PATH ou DECK_RENDER_DOCKER=<image>. Avec ni l'un ni l'autre, render refuse plutôt que de prétendre que la mise en page a été vérifiée — dites-le et revenez à build.

Modèle de sortie

Rapport après une construction :

빌드 완료 — <출력 경로>
  슬라이드 <N>개 · 템플릿 <이름> · 이미지 <M>개 삽입
  렌더 검사 — 겹침 0건 (또는: 3페이지 제목이 본문과 겹칩니다)

아키타입 사용
  @s1 ×1  표지
  @s3 ×4  본문

확인 필요
  · 3번 슬라이드 title 58자 (프레임 ~39자/줄) — 두 줄로 넘어갑니다
  · 5번 슬라이드 chart1 — 차트 수치는 템플릿 값 그대로입니다

다음 수정은 deck.mdx만 고치고 다시 build 하세요. 출력 pptx는 손대면 날아갑니다.

Ce que fait Claude / Ce que vous faites

ClaudeVous
Demande le pptx de référence, refuse de continuer sansFournit le modèle — obligatoire — et le contenu brut
Exécute catalog, lit le plan des emplacementsRévise la liste des archétypes
Propose le plan archétype par diapositiveApprouve ou réorganise le plan
Écrit et révise deck.mdxÉdite deck.mdx directement quand vous préférez
Exécute check, rapporte chaque avertissementDécide si un avertissement de débordement est important
Exécute render, regarde les aperçus, rapporte les collisionsOuvre le pptx, édite les graphiques si nécessaire

Limitations

Les six qui changent ce que vous pouvez promettre :

LimiteConséquence
Aucune nouvelle mise en pageChaque diapositive est un clone. Le contenu sans archétype nécessite d'étendre le modèle dans PowerPoint — dites-le plutôt que d'approximer.
Un modèle est obligatoirePas de design intégré, pas de solution de repli.
Les graphiques ne sont pas modifiablesbuild laisse les chiffres du modèle. Utilisez un SVG dans un emplacement d'image.
Les cadres ne bougent jamaisÉcrivez court et l'espace reste ; check le signale, seul le modèle peut le fermer.
La vérité de la mise en page nécessite un moteur de renducheck estime et ne peut pas résoudre les marges inférieures à une ligne. Seul render voit ce qui entre en collision.
La lisibilité est en PNG uniquementLe texte sur un fond JPEG ou SVG n'est pas noté ; les couleurs de texte héritées sont laissées intactes.

Tableau complet, et quelle étape détecte chacune : references/limits.md.

Compétences associées

  • write:plans (objectif du document) — développer le contenu avant de le mapper sur les diapositives
  • think:untangle-thoughts — transformer des notes éparses en la structure diapositive par diapositive dont l'Étape 2 a besoin

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

Skills associés