convez.ai
SkillProdutividadeIntermediário
m925855108

Personal Style Slides

m925855108/personal-style-slides

Aprenda seu estilo em slides e gere HTML personalizado com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que aprende seu estilo pessoal a partir de templates, decks antigos ou screenshots e gera slides HTML personalizados. Usa feedback iterativo para refinar a estética, mantendo coesão visual sem depender de temas genéricos. Ideal para apresentações acadêmicas onde consistência de design é crítica.

Instalação

$npx convez-ai m925855108/personal-style-slides

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Apresentações de defesa de tese/dissertação mantendo identidade visual
  • Relatórios de pesquisa com proporção imagem-texto consistente
  • Seminários de grupo e apresentações acadêmicas personalizadas
  • Geração rápida de slides a partir de modelos aprovados pelo pesquisador

Veredito

Solução bem pensada para pesquisadores que precisam de coesão visual sem sair do HTML. Abordagem inteligente de aprender estilo a partir de templates, com guardrails de segurança de layout. Limitação clara: output é HTML, não PPTX editável — apropriado para seu público-alvo, mas requer aceitação dessa escolha.

README

A tradução para o português deste README ainda está na fila.

Personal Style Slides

让 Codex / Claude 学你的模板,然后按你的审美生成 HTML slides。

中文 | English

为什么做这个

做科研汇报最烦的地方,往往不是“做一页 slide”,而是每次都要重新找回自己的风格:标题怎么放、图多大、文字密度多少、图注放哪里、页脚怎么对齐。

通用模板能帮一点,但很容易变成别人的 PPT。这个 skill 的思路比较直接:

你认可的模板 / 旧 deck / 截图
        |
        v
提取一个紧凑的风格种子
        |
        v
让 Codex / Claude 按这个风格生成或修改 HTML slides
        |
        v
你反馈后,再决定要不要写入本地风格记忆

它主要为博士开题、答辩、组会、文献汇报、模拟结果汇报和学术演示准备。也可以用在别的个性化 slide 场景,只要你的目标是“按我的模板和审美来”,而不是套一个通用主题。

先说清楚边界:默认输出是浏览器可打开的 HTML slides,不是 PowerPoint 里可继续编辑的原生 .pptx 文件。 PPTX 可以作为风格参考或素材来源,但这个项目目前不是高保真 PPTX 复刻器,也不是一键 PPTX 生成器。

核心特性

  • 模板驱动:从你认可的 PPTX、HTML deck、PDF、旧 deck 或截图里学习风格。
  • 个人化优先:保留你的标题习惯、图文比例、内容密度、图注风格和页面节奏。
  • HTML-first:默认生成 index.html + 本地资源目录,适合浏览器演示和 PDF/print 方向检查。
  • 科研友好:强调真实图像、来源追踪、谨慎表述,不鼓励随便换图或编结论。
  • 版式安全护栏:提供 layout_safety.css 和渲染后 DOM 检查,尽量减少拥挤、溢出和遮挡。
  • 风格指纹比较:用可解释的颜色、字号、密度、图文比例和 layout motif 比较结果是否偏离模板。
  • 轻量风格记忆:只有你明确同意时,才把长期偏好写入本地 style_memory。
  • 可降级检查:有 Playwright 就做渲染验证;没有也会跑静态检查,并说明哪些东西没验证。
  • 隐私默认本地:真实模板、未发表图、机构 logo、导师批注和个人风格记忆都不应该提交到公开仓库。

快速开始

这个仓库有两层。真正要安装的是里面的 skill 子目录,不是仓库根目录。

repo root/
  README.md
  README_EN.md
  requirements.txt
  examples_demo/

  personal-style-slides/   # 安装这个目录
    SKILL.md
    agents/
    assets/
    references/
    scripts/

如果你使用支持 GitHub URL 的 skill installer,请指向子目录:

https://github.com/m925855108/personal-style-slides/tree/main/personal-style-slides

Codex installer 示例:

python install-skill-from-github.py --repo m925855108/personal-style-slides --path personal-style-slides --dest D:/CodexSkills

如果直接给仓库根地址:

https://github.com/m925855108/personal-style-slides

安装器可能会报错,因为它不知道哪个子目录才是真正的 skill。

手动安装到 Codex

git clone https://github.com/m925855108/personal-style-slides.git
cp -r personal-style-slides/personal-style-slides ~/.codex/skills/

Windows PowerShell:

git clone https://github.com/m925855108/personal-style-slides.git
Copy-Item -Recurse .\personal-style-slides\personal-style-slides "$env:USERPROFILE\.codex\skills\personal-style-slides"

手动安装到 Claude

git clone https://github.com/m925855108/personal-style-slides.git
cp -r personal-style-slides/personal-style-slides ~/.claude/skills/

Windows PowerShell:

git clone https://github.com/m925855108/personal-style-slides.git
Copy-Item -Recurse .\personal-style-slides\personal-style-slides "$env:USERPROFILE\.claude\skills\personal-style-slides"

如果你的客户端使用不同的 skills 目录,把目标路径换成实际路径即可。安装后如果没立刻识别,重启 Codex / Claude。

可以用这个 prompt 检查是否加载成功:

请检查 personal-style-slides skill 是否可用,并概括它适合做什么。

跑一个 demo

仓库里有一个合成 demo,不含私人数据。它不是复杂 PPTX 继承能力展示,只是确认脚本链路能跑通。

python examples_demo/run_demo.py

输出会写到:

examples_demo/demo_template_seed/run_output/

这个 demo 会做几件事:

  • 检查环境能力
  • 从 demo HTML 模板提取风格画像
  • 提取轻量风格指纹
  • 对 demo HTML 做静态检查

常见用法

1. 根据模板生成科研汇报

把你认可的模板放进本地 skill 的 assets/templates/,然后对 Codex / Claude 说:

请使用 personal-style-slides skill。
以 assets/templates/my_template.pptx 作为风格模板,根据 proposal.docx 生成一份 8 分钟博士开题报告 HTML 演示文稿。

2. 按旧 deck 风格改新内容

请使用 personal-style-slides skill。
这个旧 deck 是我认可的风格,请把新内容改成类似的版式节奏、图文比例和图注风格。

3. 快速做组会结果汇报

请使用 personal-style-slides skill。
根据这些模拟结果生成一份组会汇报,风格尽量贴近 assets/templates/ 里的模板。

4. 只改一两页

请使用 personal-style-slides skill。
只调整第 3 页,让左侧图更大,右侧解释文字保持三条以内,不要重新设计整套 deck。

小改动应该走轻流程。这个 skill 不应该因为你换一张图,就重新跑完整风格学习和正式审计。那样很烦,也没必要。

工具脚本

这些脚本是给 agent 调用的辅助工具。你也可以手动跑。它们不是固定流水线,不需要每次全部执行。

脚本做什么常见时机
doctor.py检查 Python、浏览器、LibreOffice、PyMuPDF、Playwright 等环境能力。安装后、脚本失败、浏览器验证不可用。
inspect_sources.py检查 PPTX、DOCX、PDF、HTML、LaTeX 或截图目录里的文字、图片、页面和模板信息;PPTX 会尝试提取字体、字号和粗略几何线索。有源文档、模板或素材目录时。
extract_style_profile.py从模板、旧 deck、PDF、HTML 或截图里提取紧凑风格种子。生成或大改 deck 前。
check_html_deck.py静态检查 HTML slides 的 section、图片路径、重复图片和风险 CSS。生成 HTML 后。
verify_rendered_deck.py用 Playwright 或本地浏览器做渲染检查、截图和 DOM box 检查。布局风险较高,或需要截图证据时。
extract_style_fingerprint.py提取轻量风格指纹,包括颜色、字号、密度、图文比例、layout motif 和 CSS/class 线索。要比较模板和生成结果时。
compare_style_fingerprint.py比较两个风格指纹,报告匹配、漂移和需要人工复核的地方。检查结果是否大体保留模板风格。
update_style_memory.py查看、追加或移除本地 style memory。只有你明确同意长期记住某个偏好时。
style_utils.py内部公共函数。通常不用直接跑。

assets/layout_safety.css 不是主题模板,而是一组中性的版式安全护栏:标题区、内容区、页脚区预留空间,限制图片高度,并用 grid/flex 减少 HTML slide 里常见的拥挤和遮挡。正式做 deck 时可以按你的模板风格改色、改间距,但不建议删掉这些安全边界。

对自定义 HTML,verify_rendered_deck.py --generic-mode 可以减少“不是 Reveal.js 就无法验证”的问题;如果报告 verification-incomplete,说明截图可能有了,但 DOM 重叠检查没有真正完成。

手动跑几个常见检查:

python personal-style-slides/scripts/doctor.py
python personal-style-slides/scripts/extract_style_profile.py personal-style-slides/assets/templates/my_template.pptx
python personal-style-slides/scripts/check_html_deck.py outputs/index.html
python personal-style-slides/scripts/verify_rendered_deck.py outputs/index.html --out-dir render_check

如果输出是自定义 HTML,而不是 Reveal.js deck,渲染检查建议加:

python personal-style-slides/scripts/verify_rendered_deck.py outputs/index.html --generic-mode --out-dir render_check

--generic-mode 会用 [data-slide] / .slide / section 来枚举页面。它是为了让个性化 HTML 也能被检查,不是要求所有 deck 都必须长成 Reveal.js。

配置和依赖

skill 本体可以直接安装。下面这些依赖只影响辅助脚本能力:

pip install -r requirements.txt
python -m playwright install chromium

依赖能力大概是这样:

环境能力能做什么限制
无额外依赖安装 skill、读取说明、生成/修改 HTML slides、运行部分标准库脚本。PDF/PPTX 视觉解析和浏览器 DOM 验证会降级。
PyMuPDF / pypdf改善 PDF 文本、图片和页面渲染读取。PDF 里的矢量图、组合图和复杂版式仍可能需要截图或人工裁剪。
LibreOffice + PyMuPDF尝试 PPTX -> PDF -> PNG 页面渲染,把 PPTX 页面截图作为视觉参考。仍不是完整 PPTX 语义解析,不能保证还原每个 shape、裁剪或动画。
Playwright + Chromium做更可靠的浏览器截图、DOM box、溢出和加载检查。只能降低风险,不能替代最终人工看图。

默认建议把用户自己的材料放在本地安装目录里:

personal-style-slides/
  assets/
    templates/      # 你的模板、旧 deck、HTML starter
    examples/       # 你认可的历史示例,可选
    style_memory/   # 长期偏好和负面偏好,只在你同意时写入

不要把真实模板、未发表结果图、机构 logo、导师批注、个人 style memory、商业字体或系统字体提交到公开仓库。

测试

仓库包含最小 smoke tests:

python -m unittest discover tests

这些测试覆盖:

  • HTML 静态检查
  • 缺失图片报错
  • demo 风格画像提取
  • 风格指纹比较

它们能防止脚本升级时静默坏掉,但不代表完整视觉质量验收。

现在还做不到什么

直接说,别期待它现在解决所有 slide 问题。

  • 它是 skill 包,不是独立 Web app,也不是完整 CLI 产品。
  • 默认生成 HTML slides,不直接生成可编辑 .pptx。
  • 风格提取是紧凑风格种子,不是完整视觉重建。
  • PPTX 可以作为模板和素材来源,但不能保证高保真复刻 PowerPoint 版式、裁剪、动画或所有 shape 语义。
  • 风格指纹比较只是辅助判断,不能证明“看起来完全像”。它更像一组可解释的个人风格特征,不是训练出来的小模型。
  • 静态 HTML 检查不能证明浏览器渲染后没有重叠。
  • 浏览器渲染验证会检查更多风险,比如标题/正文/页脚冲突、文本密度、多图拥挤和中间窄带布局;但最后还是建议人工看截图。

贡献

欢迎提 issue 或 PR。比较有价值的方向:

  • 更好的 demo,特别是多页中文科研汇报和复杂图文场景。
  • 更强的 PPTX 页面截图和 layout fingerprint。
  • 更稳的浏览器渲染检查。
  • 更多测试用例,尤其是缺图、溢出、字体、公式和多图场景。
  • 文档里的真实使用案例和失败案例。

提交前建议至少跑:

python examples_demo/run_demo.py
python -m unittest discover tests

如果改了 skill 本体,也建议用 Codex 的 skill validator 检查 personal-style-slides/ 目录。

Credits

Created by @MV with Codex.

License

MIT

Ver o original no GitHub

Bom para

Relacionados