@kolbo/kolbo-code-linux-arm64-musl 1.1.73 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/bin/kolbo +0 -0
  2. package/package.json +1 -1
  3. package/skills/brainstorming/SKILL.md +164 -0
  4. package/skills/brainstorming/scripts/frame-template.html +214 -0
  5. package/skills/brainstorming/scripts/helper.js +88 -0
  6. package/skills/brainstorming/scripts/server.cjs +354 -0
  7. package/skills/brainstorming/scripts/start-server.sh +148 -0
  8. package/skills/brainstorming/scripts/stop-server.sh +56 -0
  9. package/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
  10. package/skills/brainstorming/visual-companion.md +287 -0
  11. package/skills/dispatching-parallel-agents/SKILL.md +182 -0
  12. package/skills/docx/.skillfish.json +10 -0
  13. package/skills/docx/SKILL.md +196 -0
  14. package/skills/docx/docx-js.md +350 -0
  15. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  16. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  17. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  18. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  19. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  20. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  21. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  22. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  23. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  24. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  25. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  26. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  27. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  28. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  29. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  30. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  31. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  32. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  33. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  34. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  35. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  36. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  37. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  38. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  39. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  40. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  41. package/skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  42. package/skills/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  43. package/skills/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  44. package/skills/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  45. package/skills/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  46. package/skills/docx/ooxml/schemas/mce/mc.xsd +75 -0
  47. package/skills/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  48. package/skills/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  49. package/skills/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  50. package/skills/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  51. package/skills/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  52. package/skills/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  53. package/skills/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  54. package/skills/docx/ooxml/scripts/pack.py +159 -0
  55. package/skills/docx/ooxml/scripts/unpack.py +29 -0
  56. package/skills/docx/ooxml/scripts/validate.py +69 -0
  57. package/skills/docx/ooxml/scripts/validation/__init__.py +15 -0
  58. package/skills/docx/ooxml/scripts/validation/base.py +951 -0
  59. package/skills/docx/ooxml/scripts/validation/docx.py +274 -0
  60. package/skills/docx/ooxml/scripts/validation/pptx.py +315 -0
  61. package/skills/docx/ooxml/scripts/validation/redlining.py +279 -0
  62. package/skills/docx/ooxml.md +599 -0
  63. package/skills/docx/scripts/__init__.py +1 -0
  64. package/skills/docx/scripts/document.py +1272 -0
  65. package/skills/docx/scripts/templates/comments.xml +3 -0
  66. package/skills/docx/scripts/templates/commentsExtended.xml +3 -0
  67. package/skills/docx/scripts/templates/commentsExtensible.xml +3 -0
  68. package/skills/docx/scripts/templates/commentsIds.xml +3 -0
  69. package/skills/docx/scripts/templates/people.xml +3 -0
  70. package/skills/docx/scripts/utilities.py +374 -0
  71. package/skills/executing-plans/SKILL.md +70 -0
  72. package/skills/finishing-a-development-branch/SKILL.md +200 -0
  73. package/skills/fullstack-app/SKILL.md +621 -0
  74. package/skills/kolbo/SKILL.md +19 -263
  75. package/skills/ollama-vision/SKILL.md +105 -0
  76. package/skills/pdf/.skillfish.json +10 -0
  77. package/skills/pdf/FORMS.md +205 -0
  78. package/skills/pdf/REFERENCE.md +612 -0
  79. package/skills/pdf/SKILL.md +293 -0
  80. package/skills/pdf/scripts/check_bounding_boxes.py +70 -0
  81. package/skills/pdf/scripts/check_bounding_boxes_test.py +226 -0
  82. package/skills/pdf/scripts/check_fillable_fields.py +12 -0
  83. package/skills/pdf/scripts/convert_pdf_to_images.py +35 -0
  84. package/skills/pdf/scripts/create_validation_image.py +41 -0
  85. package/skills/pdf/scripts/extract_form_field_info.py +152 -0
  86. package/skills/pdf/scripts/fill_fillable_fields.py +114 -0
  87. package/skills/pdf/scripts/fill_pdf_form_with_annotations.py +108 -0
  88. package/skills/photo-studio/SKILL.md +122 -0
  89. package/skills/pptx/.skillfish.json +10 -0
  90. package/skills/pptx/SKILL.md +483 -0
  91. package/skills/pptx/html2pptx.md +626 -0
  92. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  93. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  94. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  95. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  96. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  97. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  98. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  99. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  100. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  101. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  102. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  103. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  104. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  105. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  106. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  107. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  108. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  109. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  110. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  111. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  112. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  113. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  114. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  115. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  116. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  117. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  118. package/skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  119. package/skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  120. package/skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  121. package/skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  122. package/skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  123. package/skills/pptx/ooxml/schemas/mce/mc.xsd +75 -0
  124. package/skills/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  125. package/skills/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  126. package/skills/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  127. package/skills/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  128. package/skills/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  129. package/skills/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  130. package/skills/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  131. package/skills/pptx/ooxml/scripts/pack.py +159 -0
  132. package/skills/pptx/ooxml/scripts/unpack.py +29 -0
  133. package/skills/pptx/ooxml/scripts/validate.py +69 -0
  134. package/skills/pptx/ooxml/scripts/validation/__init__.py +15 -0
  135. package/skills/pptx/ooxml/scripts/validation/base.py +951 -0
  136. package/skills/pptx/ooxml/scripts/validation/docx.py +274 -0
  137. package/skills/pptx/ooxml/scripts/validation/pptx.py +315 -0
  138. package/skills/pptx/ooxml/scripts/validation/redlining.py +279 -0
  139. package/skills/pptx/ooxml.md +427 -0
  140. package/skills/pptx/scripts/html2pptx.js +995 -0
  141. package/skills/pptx/scripts/inventory.py +1020 -0
  142. package/skills/pptx/scripts/rearrange.py +231 -0
  143. package/skills/pptx/scripts/replace.py +385 -0
  144. package/skills/pptx/scripts/thumbnail.py +450 -0
  145. package/skills/receiving-code-review/SKILL.md +213 -0
  146. package/skills/requesting-code-review/SKILL.md +105 -0
  147. package/skills/requesting-code-review/code-reviewer.md +146 -0
  148. package/skills/subagent-driven-development/SKILL.md +277 -0
  149. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +26 -0
  150. package/skills/subagent-driven-development/implementer-prompt.md +113 -0
  151. package/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  152. package/skills/supabase/.skillfish.json +10 -0
  153. package/skills/supabase/SKILL.md +106 -0
  154. package/skills/supabase/assets/feedback-issue-template.md +17 -0
  155. package/skills/supabase/references/skill-feedback.md +17 -0
  156. package/skills/supabase-postgres-best-practices/.skillfish.json +10 -0
  157. package/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  158. package/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  159. package/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  160. package/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  161. package/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  162. package/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  163. package/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  164. package/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  165. package/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  166. package/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  167. package/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  168. package/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  169. package/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  170. package/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  171. package/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  172. package/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  173. package/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  174. package/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  175. package/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  176. package/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  177. package/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  178. package/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  179. package/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  180. package/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  181. package/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  182. package/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  183. package/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  184. package/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  185. package/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  186. package/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  187. package/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  188. package/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  189. package/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  190. package/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  191. package/skills/supabase-postgres-best-practices/references/security-rls-performance.md +57 -0
  192. package/skills/supabase-quickstart/SKILL.md +400 -0
  193. package/skills/systematic-debugging/CREATION-LOG.md +119 -0
  194. package/skills/systematic-debugging/SKILL.md +296 -0
  195. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  196. package/skills/systematic-debugging/condition-based-waiting.md +115 -0
  197. package/skills/systematic-debugging/defense-in-depth.md +122 -0
  198. package/skills/systematic-debugging/find-polluter.sh +63 -0
  199. package/skills/systematic-debugging/root-cause-tracing.md +169 -0
  200. package/skills/systematic-debugging/test-academic.md +14 -0
  201. package/skills/systematic-debugging/test-pressure-1.md +58 -0
  202. package/skills/systematic-debugging/test-pressure-2.md +68 -0
  203. package/skills/systematic-debugging/test-pressure-3.md +69 -0
  204. package/skills/test-driven-development/SKILL.md +371 -0
  205. package/skills/test-driven-development/testing-anti-patterns.md +299 -0
  206. package/skills/using-git-worktrees/SKILL.md +218 -0
  207. package/skills/using-superpowers/SKILL.md +115 -0
  208. package/skills/using-superpowers/references/codex-tools.md +100 -0
  209. package/skills/using-superpowers/references/gemini-tools.md +33 -0
  210. package/skills/verification-before-completion/SKILL.md +139 -0
  211. package/skills/video-production/SKILL.md +8 -7
  212. package/skills/writing-plans/SKILL.md +152 -0
  213. package/skills/writing-plans/plan-document-reviewer-prompt.md +49 -0
  214. package/skills/writing-skills/SKILL.md +655 -0
  215. package/skills/writing-skills/anthropic-best-practices.md +1150 -0
  216. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  217. package/skills/writing-skills/graphviz-conventions.dot +172 -0
  218. package/skills/writing-skills/persuasion-principles.md +187 -0
  219. package/skills/writing-skills/render-graphs.js +168 -0
  220. package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  221. package/skills/xlsx/.skillfish.json +10 -0
  222. package/skills/xlsx/SKILL.md +288 -0
  223. package/skills/xlsx/recalc.py +178 -0
  224. package/skills/color-grading/SKILL.md +0 -152
  225. package/skills/ffmpeg-patterns/SKILL.md +0 -240
  226. package/skills/image-prompting-guide/SKILL.md +0 -143
  227. package/skills/music-prompting/SKILL.md +0 -146
  228. package/skills/production-review/SKILL.md +0 -152
  229. package/skills/short-form-video/SKILL.md +0 -168
  230. package/skills/sound-design/SKILL.md +0 -154
  231. package/skills/storytelling/SKILL.md +0 -139
  232. package/skills/subtitle-production/SKILL.md +0 -244
  233. package/skills/subtitle-production/reference/burn_to_video.py +0 -222
  234. package/skills/subtitle-production/reference/export_srts.py +0 -127
  235. package/skills/subtitle-production/reference/gen_srt.py +0 -42
  236. package/skills/typography-video/SKILL.md +0 -182
  237. package/skills/typography-video/reference/KineticTitleScene.tsx +0 -345
  238. package/skills/video-editing/SKILL.md +0 -128
  239. package/skills/video-prompting-guide/SKILL.md +0 -268
@@ -0,0 +1,483 @@
1
+ ---
2
+ name: pptx
3
+ description: "Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks"
4
+ ---
5
+
6
+ # PPTX creation, editing, and analysis
7
+
8
+ ## Overview
9
+
10
+ A user may ask you to create, edit, or analyze the contents of a .pptx file. A .pptx file is essentially a ZIP archive containing XML files and other resources that you can read or edit. You have different tools and workflows available for different tasks.
11
+
12
+ ## Reading and analyzing content
13
+
14
+ ### Text extraction
15
+ If you just need to read the text contents of a presentation, you should convert the document to markdown:
16
+
17
+ ```bash
18
+ # Convert document to markdown
19
+ python -m markitdown path-to-file.pptx
20
+ ```
21
+
22
+ ### Raw XML access
23
+ You need raw XML access for: comments, speaker notes, slide layouts, animations, design elements, and complex formatting. For any of these features, you'll need to unpack a presentation and read its raw XML contents.
24
+
25
+ #### Unpacking a file
26
+ `python ooxml/scripts/unpack.py <office_file> <output_dir>`
27
+
28
+ **Note**: The unpack.py script is located at `skills/pptx/ooxml/scripts/unpack.py` relative to the project root. If the script doesn't exist at this path, use `find . -name "unpack.py"` to locate it.
29
+
30
+ #### Key file structures
31
+ * `ppt/presentation.xml` - Main presentation metadata and slide references
32
+ * `ppt/slides/slide{N}.xml` - Individual slide contents (slide1.xml, slide2.xml, etc.)
33
+ * `ppt/notesSlides/notesSlide{N}.xml` - Speaker notes for each slide
34
+ * `ppt/comments/modernComment_*.xml` - Comments for specific slides
35
+ * `ppt/slideLayouts/` - Layout templates for slides
36
+ * `ppt/slideMasters/` - Master slide templates
37
+ * `ppt/theme/` - Theme and styling information
38
+ * `ppt/media/` - Images and other media files
39
+
40
+ #### Typography and color extraction
41
+ **When given an example design to emulate**: Always analyze the presentation's typography and colors first using the methods below:
42
+ 1. **Read theme file**: Check `ppt/theme/theme1.xml` for colors (`<a:clrScheme>`) and fonts (`<a:fontScheme>`)
43
+ 2. **Sample slide content**: Examine `ppt/slides/slide1.xml` for actual font usage (`<a:rPr>`) and colors
44
+ 3. **Search for patterns**: Use grep to find color (`<a:solidFill>`, `<a:srgbClr>`) and font references across all XML files
45
+
46
+ ## Creating a new PowerPoint presentation **without a template**
47
+
48
+ When creating a new PowerPoint presentation from scratch, use the **html2pptx** workflow to convert HTML slides to PowerPoint with accurate positioning.
49
+
50
+ ### Design Principles
51
+
52
+ **CRITICAL**: Before creating any presentation, analyze the content and choose appropriate design elements:
53
+ 1. **Consider the subject matter**: What is this presentation about? What tone, industry, or mood does it suggest?
54
+ 2. **Check for branding**: If the user mentions a company/organization, consider their brand colors and identity
55
+ 3. **Match palette to content**: Select colors that reflect the subject
56
+ 4. **State your approach**: Explain your design choices before writing code
57
+
58
+ **Requirements**:
59
+ - ✅ State your content-informed design approach BEFORE writing code
60
+ - ✅ Use web-safe fonts only: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
61
+ - ✅ Create clear visual hierarchy through size, weight, and color
62
+ - ✅ Ensure readability: strong contrast, appropriately sized text, clean alignment
63
+ - ✅ Be consistent: repeat patterns, spacing, and visual language across slides
64
+
65
+ #### Color Palette Selection
66
+
67
+ **Choosing colors creatively**:
68
+ - **Think beyond defaults**: What colors genuinely match this specific topic? Avoid autopilot choices.
69
+ - **Consider multiple angles**: Topic, industry, mood, energy level, target audience, brand identity (if mentioned)
70
+ - **Be adventurous**: Try unexpected combinations - a healthcare presentation doesn't have to be green, finance doesn't have to be navy
71
+ - **Build your palette**: Pick 3-5 colors that work together (dominant colors + supporting tones + accent)
72
+ - **Ensure contrast**: Text must be clearly readable on backgrounds
73
+
74
+ **Example color palettes** (use these to spark creativity - choose one, adapt it, or create your own):
75
+
76
+ 1. **Classic Blue**: Deep navy (#1C2833), slate gray (#2E4053), silver (#AAB7B8), off-white (#F4F6F6)
77
+ 2. **Teal & Coral**: Teal (#5EA8A7), deep teal (#277884), coral (#FE4447), white (#FFFFFF)
78
+ 3. **Bold Red**: Red (#C0392B), bright red (#E74C3C), orange (#F39C12), yellow (#F1C40F), green (#2ECC71)
79
+ 4. **Warm Blush**: Mauve (#A49393), blush (#EED6D3), rose (#E8B4B8), cream (#FAF7F2)
80
+ 5. **Burgundy Luxury**: Burgundy (#5D1D2E), crimson (#951233), rust (#C15937), gold (#997929)
81
+ 6. **Deep Purple & Emerald**: Purple (#B165FB), dark blue (#181B24), emerald (#40695B), white (#FFFFFF)
82
+ 7. **Cream & Forest Green**: Cream (#FFE1C7), forest green (#40695B), white (#FCFCFC)
83
+ 8. **Pink & Purple**: Pink (#F8275B), coral (#FF574A), rose (#FF737D), purple (#3D2F68)
84
+ 9. **Lime & Plum**: Lime (#C5DE82), plum (#7C3A5F), coral (#FD8C6E), blue-gray (#98ACB5)
85
+ 10. **Black & Gold**: Gold (#BF9A4A), black (#000000), cream (#F4F6F6)
86
+ 11. **Sage & Terracotta**: Sage (#87A96B), terracotta (#E07A5F), cream (#F4F1DE), charcoal (#2C2C2C)
87
+ 12. **Charcoal & Red**: Charcoal (#292929), red (#E33737), light gray (#CCCBCB)
88
+ 13. **Vibrant Orange**: Orange (#F96D00), light gray (#F2F2F2), charcoal (#222831)
89
+ 14. **Forest Green**: Black (#191A19), green (#4E9F3D), dark green (#1E5128), white (#FFFFFF)
90
+ 15. **Retro Rainbow**: Purple (#722880), pink (#D72D51), orange (#EB5C18), amber (#F08800), gold (#DEB600)
91
+ 16. **Vintage Earthy**: Mustard (#E3B448), sage (#CBD18F), forest green (#3A6B35), cream (#F4F1DE)
92
+ 17. **Coastal Rose**: Old rose (#AD7670), beaver (#B49886), eggshell (#F3ECDC), ash gray (#BFD5BE)
93
+ 18. **Orange & Turquoise**: Light orange (#FC993E), grayish turquoise (#667C6F), white (#FCFCFC)
94
+
95
+ #### Visual Details Options
96
+
97
+ **Geometric Patterns**:
98
+ - Diagonal section dividers instead of horizontal
99
+ - Asymmetric column widths (30/70, 40/60, 25/75)
100
+ - Rotated text headers at 90° or 270°
101
+ - Circular/hexagonal frames for images
102
+ - Triangular accent shapes in corners
103
+ - Overlapping shapes for depth
104
+
105
+ **Border & Frame Treatments**:
106
+ - Thick single-color borders (10-20pt) on one side only
107
+ - Double-line borders with contrasting colors
108
+ - Corner brackets instead of full frames
109
+ - L-shaped borders (top+left or bottom+right)
110
+ - Underline accents beneath headers (3-5pt thick)
111
+
112
+ **Typography Treatments**:
113
+ - Extreme size contrast (72pt headlines vs 11pt body)
114
+ - All-caps headers with wide letter spacing
115
+ - Numbered sections in oversized display type
116
+ - Monospace (Courier New) for data/stats/technical content
117
+ - Condensed fonts (Arial Narrow) for dense information
118
+ - Outlined text for emphasis
119
+
120
+ **Chart & Data Styling**:
121
+ - Monochrome charts with single accent color for key data
122
+ - Horizontal bar charts instead of vertical
123
+ - Dot plots instead of bar charts
124
+ - Minimal gridlines or none at all
125
+ - Data labels directly on elements (no legends)
126
+ - Oversized numbers for key metrics
127
+
128
+ **Layout Innovations**:
129
+ - Full-bleed images with text overlays
130
+ - Sidebar column (20-30% width) for navigation/context
131
+ - Modular grid systems (3×3, 4×4 blocks)
132
+ - Z-pattern or F-pattern content flow
133
+ - Floating text boxes over colored shapes
134
+ - Magazine-style multi-column layouts
135
+
136
+ **Background Treatments**:
137
+ - Solid color blocks occupying 40-60% of slide
138
+ - Gradient fills (vertical or diagonal only)
139
+ - Split backgrounds (two colors, diagonal or vertical)
140
+ - Edge-to-edge color bands
141
+ - Negative space as a design element
142
+
143
+ ### Layout Tips
144
+ **When creating slides with charts or tables:**
145
+ - **Two-column layout (PREFERRED)**: Use a header spanning the full width, then two columns below - text/bullets in one column and the featured content in the other. This provides better balance and makes charts/tables more readable. Use flexbox with unequal column widths (e.g., 40%/60% split) to optimize space for each content type.
146
+ - **Full-slide layout**: Let the featured content (chart/table) take up the entire slide for maximum impact and readability
147
+ - **NEVER vertically stack**: Do not place charts/tables below text in a single column - this causes poor readability and layout issues
148
+
149
+ ### Workflow
150
+ 1. **MANDATORY - READ ENTIRE FILE**: Read [`html2pptx.md`](html2pptx.md) completely from start to finish. **NEVER set any range limits when reading this file.** Read the full file content for detailed syntax, critical formatting rules, and best practices before proceeding with presentation creation.
151
+ 2. Create an HTML file for each slide with proper dimensions (e.g., 720pt × 405pt for 16:9)
152
+ - Use `<p>`, `<h1>`-`<h6>`, `<ul>`, `<ol>` for all text content
153
+ - Use `class="placeholder"` for areas where charts/tables will be added (render with gray background for visibility)
154
+ - **CRITICAL**: Rasterize gradients and icons as PNG images FIRST using Sharp, then reference in HTML
155
+ - **LAYOUT**: For slides with charts/tables/images, use either full-slide layout or two-column layout for better readability
156
+ 3. Create and run a JavaScript file using the [`html2pptx.js`](scripts/html2pptx.js) library to convert HTML slides to PowerPoint and save the presentation
157
+ - Use the `html2pptx()` function to process each HTML file
158
+ - Add charts and tables to placeholder areas using PptxGenJS API
159
+ - Save the presentation using `pptx.writeFile()`
160
+ 4. **Visual validation**: Generate thumbnails and inspect for layout issues
161
+ - Create thumbnail grid: `python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4`
162
+ - Read and carefully examine the thumbnail image for:
163
+ - **Text cutoff**: Text being cut off by header bars, shapes, or slide edges
164
+ - **Text overlap**: Text overlapping with other text or shapes
165
+ - **Positioning issues**: Content too close to slide boundaries or other elements
166
+ - **Contrast issues**: Insufficient contrast between text and backgrounds
167
+ - If issues found, adjust HTML margins/spacing/colors and regenerate the presentation
168
+ - Repeat until all slides are visually correct
169
+
170
+ ## Editing an existing PowerPoint presentation
171
+
172
+ When edit slides in an existing PowerPoint presentation, you need to work with the raw Office Open XML (OOXML) format. This involves unpacking the .pptx file, editing the XML content, and repacking it.
173
+
174
+ ### Workflow
175
+ 1. **MANDATORY - READ ENTIRE FILE**: Read [`ooxml.md`](ooxml.md) (~500 lines) completely from start to finish. **NEVER set any range limits when reading this file.** Read the full file content for detailed guidance on OOXML structure and editing workflows before any presentation editing.
176
+ 2. Unpack the presentation: `python ooxml/scripts/unpack.py <office_file> <output_dir>`
177
+ 3. Edit the XML files (primarily `ppt/slides/slide{N}.xml` and related files)
178
+ 4. **CRITICAL**: Validate immediately after each edit and fix any validation errors before proceeding: `python ooxml/scripts/validate.py <dir> --original <file>`
179
+ 5. Pack the final presentation: `python ooxml/scripts/pack.py <input_directory> <office_file>`
180
+
181
+ ## Creating a new PowerPoint presentation **using a template**
182
+
183
+ When you need to create a presentation that follows an existing template's design, you'll need to duplicate and re-arrange template slides before then replacing placeholder context.
184
+
185
+ ### Workflow
186
+ 1. **Extract template text AND create visual thumbnail grid**:
187
+ * Extract text: `python -m markitdown template.pptx > template-content.md`
188
+ * Read `template-content.md`: Read the entire file to understand the contents of the template presentation. **NEVER set any range limits when reading this file.**
189
+ * Create thumbnail grids: `python scripts/thumbnail.py template.pptx`
190
+ * See [Creating Thumbnail Grids](#creating-thumbnail-grids) section for more details
191
+
192
+ 2. **Analyze template and save inventory to a file**:
193
+ * **Visual Analysis**: Review thumbnail grid(s) to understand slide layouts, design patterns, and visual structure
194
+ * Create and save a template inventory file at `template-inventory.md` containing:
195
+ ```markdown
196
+ # Template Inventory Analysis
197
+ **Total Slides: [count]**
198
+ **IMPORTANT: Slides are 0-indexed (first slide = 0, last slide = count-1)**
199
+
200
+ ## [Category Name]
201
+ - Slide 0: [Layout code if available] - Description/purpose
202
+ - Slide 1: [Layout code] - Description/purpose
203
+ - Slide 2: [Layout code] - Description/purpose
204
+ [... EVERY slide must be listed individually with its index ...]
205
+ ```
206
+ * **Using the thumbnail grid**: Reference the visual thumbnails to identify:
207
+ - Layout patterns (title slides, content layouts, section dividers)
208
+ - Image placeholder locations and counts
209
+ - Design consistency across slide groups
210
+ - Visual hierarchy and structure
211
+ * This inventory file is REQUIRED for selecting appropriate templates in the next step
212
+
213
+ 3. **Create presentation outline based on template inventory**:
214
+ * Review available templates from step 2.
215
+ * Choose an intro or title template for the first slide. This should be one of the first templates.
216
+ * Choose safe, text-based layouts for the other slides.
217
+ * **CRITICAL: Match layout structure to actual content**:
218
+ - Single-column layouts: Use for unified narrative or single topic
219
+ - Two-column layouts: Use ONLY when you have exactly 2 distinct items/concepts
220
+ - Three-column layouts: Use ONLY when you have exactly 3 distinct items/concepts
221
+ - Image + text layouts: Use ONLY when you have actual images to insert
222
+ - Quote layouts: Use ONLY for actual quotes from people (with attribution), never for emphasis
223
+ - Never use layouts with more placeholders than you have content
224
+ - If you have 2 items, don't force them into a 3-column layout
225
+ - If you have 4+ items, consider breaking into multiple slides or using a list format
226
+ * Count your actual content pieces BEFORE selecting the layout
227
+ * Verify each placeholder in the chosen layout will be filled with meaningful content
228
+ * Select one option representing the **best** layout for each content section.
229
+ * Save `outline.md` with content AND template mapping that leverages available designs
230
+ * Example template mapping:
231
+ ```
232
+ # Template slides to use (0-based indexing)
233
+ # WARNING: Verify indices are within range! Template with 73 slides has indices 0-72
234
+ # Mapping: slide numbers from outline -> template slide indices
235
+ template_mapping = [
236
+ 0, # Use slide 0 (Title/Cover)
237
+ 34, # Use slide 34 (B1: Title and body)
238
+ 34, # Use slide 34 again (duplicate for second B1)
239
+ 50, # Use slide 50 (E1: Quote)
240
+ 54, # Use slide 54 (F2: Closing + Text)
241
+ ]
242
+ ```
243
+
244
+ 4. **Duplicate, reorder, and delete slides using `rearrange.py`**:
245
+ * Use the `scripts/rearrange.py` script to create a new presentation with slides in the desired order:
246
+ ```bash
247
+ python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52
248
+ ```
249
+ * The script handles duplicating repeated slides, deleting unused slides, and reordering automatically
250
+ * Slide indices are 0-based (first slide is 0, second is 1, etc.)
251
+ * The same slide index can appear multiple times to duplicate that slide
252
+
253
+ 5. **Extract ALL text using the `inventory.py` script**:
254
+ * **Run inventory extraction**:
255
+ ```bash
256
+ python scripts/inventory.py working.pptx text-inventory.json
257
+ ```
258
+ * **Read text-inventory.json**: Read the entire text-inventory.json file to understand all shapes and their properties. **NEVER set any range limits when reading this file.**
259
+
260
+ * The inventory JSON structure:
261
+ ```json
262
+ {
263
+ "slide-0": {
264
+ "shape-0": {
265
+ "placeholder_type": "TITLE", // or null for non-placeholders
266
+ "left": 1.5, // position in inches
267
+ "top": 2.0,
268
+ "width": 7.5,
269
+ "height": 1.2,
270
+ "paragraphs": [
271
+ {
272
+ "text": "Paragraph text",
273
+ // Optional properties (only included when non-default):
274
+ "bullet": true, // explicit bullet detected
275
+ "level": 0, // only included when bullet is true
276
+ "alignment": "CENTER", // CENTER, RIGHT (not LEFT)
277
+ "space_before": 10.0, // space before paragraph in points
278
+ "space_after": 6.0, // space after paragraph in points
279
+ "line_spacing": 22.4, // line spacing in points
280
+ "font_name": "Arial", // from first run
281
+ "font_size": 14.0, // in points
282
+ "bold": true,
283
+ "italic": false,
284
+ "underline": false,
285
+ "color": "FF0000" // RGB color
286
+ }
287
+ ]
288
+ }
289
+ }
290
+ }
291
+ ```
292
+
293
+ * Key features:
294
+ - **Slides**: Named as "slide-0", "slide-1", etc.
295
+ - **Shapes**: Ordered by visual position (top-to-bottom, left-to-right) as "shape-0", "shape-1", etc.
296
+ - **Placeholder types**: TITLE, CENTER_TITLE, SUBTITLE, BODY, OBJECT, or null
297
+ - **Default font size**: `default_font_size` in points extracted from layout placeholders (when available)
298
+ - **Slide numbers are filtered**: Shapes with SLIDE_NUMBER placeholder type are automatically excluded from inventory
299
+ - **Bullets**: When `bullet: true`, `level` is always included (even if 0)
300
+ - **Spacing**: `space_before`, `space_after`, and `line_spacing` in points (only included when set)
301
+ - **Colors**: `color` for RGB (e.g., "FF0000"), `theme_color` for theme colors (e.g., "DARK_1")
302
+ - **Properties**: Only non-default values are included in the output
303
+
304
+ 6. **Generate replacement text and save the data to a JSON file**
305
+ Based on the text inventory from the previous step:
306
+ - **CRITICAL**: First verify which shapes exist in the inventory - only reference shapes that are actually present
307
+ - **VALIDATION**: The replace.py script will validate that all shapes in your replacement JSON exist in the inventory
308
+ - If you reference a non-existent shape, you'll get an error showing available shapes
309
+ - If you reference a non-existent slide, you'll get an error indicating the slide doesn't exist
310
+ - All validation errors are shown at once before the script exits
311
+ - **IMPORTANT**: The replace.py script uses inventory.py internally to identify ALL text shapes
312
+ - **AUTOMATIC CLEARING**: ALL text shapes from the inventory will be cleared unless you provide "paragraphs" for them
313
+ - Add a "paragraphs" field to shapes that need content (not "replacement_paragraphs")
314
+ - Shapes without "paragraphs" in the replacement JSON will have their text cleared automatically
315
+ - Paragraphs with bullets will be automatically left aligned. Don't set the `alignment` property on when `"bullet": true`
316
+ - Generate appropriate replacement content for placeholder text
317
+ - Use shape size to determine appropriate content length
318
+ - **CRITICAL**: Include paragraph properties from the original inventory - don't just provide text
319
+ - **IMPORTANT**: When bullet: true, do NOT include bullet symbols (•, -, *) in text - they're added automatically
320
+ - **ESSENTIAL FORMATTING RULES**:
321
+ - Headers/titles should typically have `"bold": true`
322
+ - List items should have `"bullet": true, "level": 0` (level is required when bullet is true)
323
+ - Preserve any alignment properties (e.g., `"alignment": "CENTER"` for centered text)
324
+ - Include font properties when different from default (e.g., `"font_size": 14.0`, `"font_name": "Lora"`)
325
+ - Colors: Use `"color": "FF0000"` for RGB or `"theme_color": "DARK_1"` for theme colors
326
+ - The replacement script expects **properly formatted paragraphs**, not just text strings
327
+ - **Overlapping shapes**: Prefer shapes with larger default_font_size or more appropriate placeholder_type
328
+ - Save the updated inventory with replacements to `replacement-text.json`
329
+ - **WARNING**: Different template layouts have different shape counts - always check the actual inventory before creating replacements
330
+
331
+ Example paragraphs field showing proper formatting:
332
+ ```json
333
+ "paragraphs": [
334
+ {
335
+ "text": "New presentation title text",
336
+ "alignment": "CENTER",
337
+ "bold": true
338
+ },
339
+ {
340
+ "text": "Section Header",
341
+ "bold": true
342
+ },
343
+ {
344
+ "text": "First bullet point without bullet symbol",
345
+ "bullet": true,
346
+ "level": 0
347
+ },
348
+ {
349
+ "text": "Red colored text",
350
+ "color": "FF0000"
351
+ },
352
+ {
353
+ "text": "Theme colored text",
354
+ "theme_color": "DARK_1"
355
+ },
356
+ {
357
+ "text": "Regular paragraph text without special formatting"
358
+ }
359
+ ]
360
+ ```
361
+
362
+ **Shapes not listed in the replacement JSON are automatically cleared**:
363
+ ```json
364
+ {
365
+ "slide-0": {
366
+ "shape-0": {
367
+ "paragraphs": [...] // This shape gets new text
368
+ }
369
+ // shape-1 and shape-2 from inventory will be cleared automatically
370
+ }
371
+ }
372
+ ```
373
+
374
+ **Common formatting patterns for presentations**:
375
+ - Title slides: Bold text, sometimes centered
376
+ - Section headers within slides: Bold text
377
+ - Bullet lists: Each item needs `"bullet": true, "level": 0`
378
+ - Body text: Usually no special properties needed
379
+ - Quotes: May have special alignment or font properties
380
+
381
+ 7. **Apply replacements using the `replace.py` script**
382
+ ```bash
383
+ python scripts/replace.py working.pptx replacement-text.json output.pptx
384
+ ```
385
+
386
+ The script will:
387
+ - First extract the inventory of ALL text shapes using functions from inventory.py
388
+ - Validate that all shapes in the replacement JSON exist in the inventory
389
+ - Clear text from ALL shapes identified in the inventory
390
+ - Apply new text only to shapes with "paragraphs" defined in the replacement JSON
391
+ - Preserve formatting by applying paragraph properties from the JSON
392
+ - Handle bullets, alignment, font properties, and colors automatically
393
+ - Save the updated presentation
394
+
395
+ Example validation errors:
396
+ ```
397
+ ERROR: Invalid shapes in replacement JSON:
398
+ - Shape 'shape-99' not found on 'slide-0'. Available shapes: shape-0, shape-1, shape-4
399
+ - Slide 'slide-999' not found in inventory
400
+ ```
401
+
402
+ ```
403
+ ERROR: Replacement text made overflow worse in these shapes:
404
+ - slide-0/shape-2: overflow worsened by 1.25" (was 0.00", now 1.25")
405
+ ```
406
+
407
+ ## Creating Thumbnail Grids
408
+
409
+ To create visual thumbnail grids of PowerPoint slides for quick analysis and reference:
410
+
411
+ ```bash
412
+ python scripts/thumbnail.py template.pptx [output_prefix]
413
+ ```
414
+
415
+ **Features**:
416
+ - Creates: `thumbnails.jpg` (or `thumbnails-1.jpg`, `thumbnails-2.jpg`, etc. for large decks)
417
+ - Default: 5 columns, max 30 slides per grid (5×6)
418
+ - Custom prefix: `python scripts/thumbnail.py template.pptx my-grid`
419
+ - Note: The output prefix should include the path if you want output in a specific directory (e.g., `workspace/my-grid`)
420
+ - Adjust columns: `--cols 4` (range: 3-6, affects slides per grid)
421
+ - Grid limits: 3 cols = 12 slides/grid, 4 cols = 20, 5 cols = 30, 6 cols = 42
422
+ - Slides are zero-indexed (Slide 0, Slide 1, etc.)
423
+
424
+ **Use cases**:
425
+ - Template analysis: Quickly understand slide layouts and design patterns
426
+ - Content review: Visual overview of entire presentation
427
+ - Navigation reference: Find specific slides by their visual appearance
428
+ - Quality check: Verify all slides are properly formatted
429
+
430
+ **Examples**:
431
+ ```bash
432
+ # Basic usage
433
+ python scripts/thumbnail.py presentation.pptx
434
+
435
+ # Combine options: custom name, columns
436
+ python scripts/thumbnail.py template.pptx analysis --cols 4
437
+ ```
438
+
439
+ ## Converting Slides to Images
440
+
441
+ To visually analyze PowerPoint slides, convert them to images using a two-step process:
442
+
443
+ 1. **Convert PPTX to PDF**:
444
+ ```bash
445
+ soffice --headless --convert-to pdf template.pptx
446
+ ```
447
+
448
+ 2. **Convert PDF pages to JPEG images**:
449
+ ```bash
450
+ pdftoppm -jpeg -r 150 template.pdf slide
451
+ ```
452
+ This creates files like `slide-1.jpg`, `slide-2.jpg`, etc.
453
+
454
+ Options:
455
+ - `-r 150`: Sets resolution to 150 DPI (adjust for quality/size balance)
456
+ - `-jpeg`: Output JPEG format (use `-png` for PNG if preferred)
457
+ - `-f N`: First page to convert (e.g., `-f 2` starts from page 2)
458
+ - `-l N`: Last page to convert (e.g., `-l 5` stops at page 5)
459
+ - `slide`: Prefix for output files
460
+
461
+ Example for specific range:
462
+ ```bash
463
+ pdftoppm -jpeg -r 150 -f 2 -l 5 template.pdf slide # Converts only pages 2-5
464
+ ```
465
+
466
+ ## Code Style Guidelines
467
+ **IMPORTANT**: When generating code for PPTX operations:
468
+ - Write concise code
469
+ - Avoid verbose variable names and redundant operations
470
+ - Avoid unnecessary print statements
471
+
472
+ ## Dependencies
473
+
474
+ Required dependencies (should already be installed):
475
+
476
+ - **markitdown**: `pip install "markitdown[pptx]"` (for text extraction from presentations)
477
+ - **pptxgenjs**: `npm install -g pptxgenjs` (for creating presentations via html2pptx)
478
+ - **playwright**: `npm install -g playwright` (for HTML rendering in html2pptx)
479
+ - **react-icons**: `npm install -g react-icons react react-dom` (for icons)
480
+ - **sharp**: `npm install -g sharp` (for SVG rasterization and image processing)
481
+ - **LibreOffice**: `sudo apt-get install libreoffice` (for PDF conversion)
482
+ - **Poppler**: `sudo apt-get install poppler-utils` (for pdftoppm to convert PDF to images)
483
+ - **defusedxml**: `pip install defusedxml` (for secure XML parsing)