@uipath/delegate-sdk 1.203.1 → 1.203.2

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 (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,668 @@
1
+ # Generator Reference — JSON Format, Themes & Data Formats
2
+
3
+ This file contains detailed format specifications for the PowerPoint Generator.
4
+ **Loaded on demand from SKILL.md when building the generator JSON payload.**
5
+
6
+ **Endpoint:** call `ExecuteSkillApi` with `endpoint: "/ppt-gen/generate"` and the JSON below as `body`. Related endpoints: `/ppt-gen/list-themes`, `/diagram/render-mermaid`. Do NOT use `/ppt/*` — those drive an already-open PowerPoint window for editing, not creation.
7
+
8
+ ---
9
+
10
+ ## STOP — Read These 5 Rules Before Generating ANY Presentation
11
+
12
+ **These are non-negotiable. Violating any of them produces an amateur presentation.**
13
+
14
+ 1. **ACTION TITLES on every slide.** Title = complete sentence stating the conclusion. "Revenue grew 18% driven by APAC" NOT "Revenue Overview". Read your titles in sequence — they must tell the story alone.
15
+ 2. **NEVER repeat the same layout consecutively.** If slide 3 is `content`, slide 4 MUST be different (stats, comparison, chart, imageRight, timeline). Count your layouts — if any type appears 3+ times, replace one.
16
+ 3. **SEARCH/GENERATE images BEFORE building JSON.** At least 2 slides must use `imageRight` or `imageLeft`. No excuses. Do the image search first.
17
+ 4. **Max 30 words per slide body** (18 for image slides). If more, split into 2 slides.
18
+ 5. **Visual variety (default, not override):** When the user hasn't specified exact slide content, aim for at least 1 `chart` + 1 `stats` + 1 image slide + 1 `comparison` or `table`. Plain bullet slides limited to 1 per deck. **But always respect user requirements first** — if they ask for 3 text slides, don't force charts into it. Charts work in ALL theme paths (built-in, custom .thmx, classic PPT themes).
19
+ 6. **Timeline: max 4 phases per slide.** If you have 5+ phases with descriptions, split into 2 `timeline` slides. Never cram 5+ phases into one slide.
20
+
21
+ ---
22
+
23
+ ### Presentation JSON Format
24
+
25
+ **Standard format (built-in themes):**
26
+ ```json
27
+ {
28
+ "options": {
29
+ "title": "Presentation Title",
30
+ "theme": "dark-professional",
31
+ "outputPath": "/path/to/output.pptx",
32
+ "author": "Your Name",
33
+ "subject": "tech"
34
+ },
35
+ "slides": [
36
+ {
37
+ "layout": "title",
38
+ "title": "Welcome",
39
+ "subtitle": "A stunning presentation"
40
+ }
41
+ ]
42
+ }
43
+ ```
44
+
45
+ **With custom .thmx theme file (REPLACES theme option):**
46
+ ```json
47
+ {
48
+ "options": {
49
+ "title": "Presentation Title",
50
+ "themePath": "C:/path/to/custom-theme.thmx",
51
+ "outputPath": "/path/to/output.pptx",
52
+ "author": "Your Name"
53
+ },
54
+ "slides": [...]
55
+ }
56
+ ```
57
+
58
+ **🚨 IMPORTANT:** When using `themePath`, do NOT also specify `theme`.
59
+
60
+ **Other `options` fields:**
61
+ - `aspectRatio` (`'16:9'`/`'4:3'`/`'16:10'`, default `'16:9'`) — slide dimensions.
62
+ - `templatePath` — path to an existing `.pptx` to build slides on top of (requires PowerPoint; different from `themePath`, which extracts a theme rather than reusing a template file).
63
+ - `company` — shown in slide/document metadata.
64
+ - Per-slide `speakerNotes` (string) — set on any individual slide object, not in `options`, to attach notes to that slide.
65
+
66
+ ### ⚠️ Detecting Custom Theme Requests
67
+
68
+ **Triggers for custom theme workflow → READ `custom_themes.md`:**
69
+ - User mentions `.thmx` or `.pptx` file path
70
+ - "use my theme", "corporate template", "custom theme"
71
+ - Any theme file reference
72
+
73
+ **Then use `themePath` with ALL slides in the `slides` array — the Generator creates everything in ONE call.** Never use an empty `slides` array.
74
+
75
+ ### Themed Presentations — Visual Requirements
76
+
77
+ When using `themePath` (custom .thmx) or a classic PowerPoint theme (Ion, Retrospect, Facet, etc.), **the same visual richness rules apply**. The theme provides colors, fonts, and slide masters. You must still add charts, images, and visual layouts.
78
+
79
+ **Required minimum for ANY themed presentation:**
80
+ - 1+ `chart` slides with real data (bar, column, line, or pie)
81
+ - 1+ `stats` slides with key metrics
82
+ - 1+ `comparison` slides for options/contrast
83
+ - 1+ image slides (`imageRight` or `imageLeft`) with searched/generated images
84
+ - 1+ `timeline` or `features` slide for roadmaps/pillars
85
+
86
+ **Themed presentations where 4+ out of 7 slides are plain `content` layout will score LOW. Force yourself to use chart, stats, comparison, and image layouts.**
87
+
88
+ ```json
89
+ // GOOD themed presentation structure (7 slides):
90
+ { "layout": "title" }
91
+ { "layout": "stats", ... } // key metrics upfront
92
+ { "layout": "imageRight", ... } // context with visual
93
+ { "layout": "comparison", ... } // analysis/options
94
+ { "layout": "chart", ... } // data evidence
95
+ { "layout": "timeline", ... } // roadmap
96
+ { "layout": "closing", ... } // action
97
+
98
+ // BAD themed presentation (avoid this):
99
+ { "layout": "title" }
100
+ { "layout": "content" } // TEXT DUMP
101
+ { "layout": "content" } // TEXT DUMP
102
+ { "layout": "content" } // TEXT DUMP
103
+ { "layout": "content" } // TEXT DUMP
104
+ { "layout": "content" } // TEXT DUMP
105
+ { "layout": "closing" }
106
+ ```
107
+
108
+ ### Slide Design Guidelines
109
+
110
+ #### Content Density (The 3-Second Rule)
111
+
112
+ The audience should grasp the slide's point in 3 seconds. These limits enforce that:
113
+
114
+ | Layout | Max items | Max words (body) | Words per item |
115
+ |--------|-----------|-------------------|----------------|
116
+ | `content` | 4-5 bullets | 30 | 6-8 |
117
+ | `imageRight` / `imageLeft` | 3 phrases | 18 | 5-6 |
118
+ | `stats` | 4 metrics | N/A (labels only) | 3-4 per label |
119
+ | `comparison` | 3-4 per side | 25 | 6-8 |
120
+ | `timeline` | **max 4 phases** | 25 | 5-6 per phase |
121
+
122
+ **If content exceeds these limits, SPLIT across 2 slides.** Slides are cheap, readability is not.
123
+
124
+ **Timeline overflow prevention:** With a `themePath`, the content placeholder has limited height. For timelines with 4+ phases that each have descriptions, either (a) split into 2 slides (2 phases each) or (b) use very short descriptions (5 words max). Never put 5+ phases with descriptions in a single `timeline` slide.
125
+
126
+ #### Visual-to-Text Ratio
127
+
128
+ **70%+ of each slide should be visual content or white space.** Text should fill no more than 30% of the slide area. This means:
129
+ - Use `stats`, `comparison`, `timeline`, `imageRight` layouts over plain `content`
130
+ - Max 2 plain `content` slides per deck — convert the rest to visual layouts
131
+ - When in doubt, use fewer words and more white space
132
+
133
+ **Example — TOO MUCH text (will look like a Word doc):**
134
+ ```json
135
+ { "layout": "content", "title": "Analysis", "body": [
136
+ "Legacy systems are creating significant barriers to innovation and agility across the organization",
137
+ "Customer data is fragmented across multiple platforms creating inconsistent experiences",
138
+ "Manual processes are causing operational inefficiencies and increased error rates",
139
+ "Real-time inventory visibility is lacking across all retail channels",
140
+ "Omnichannel experience is inconsistent between online and in-store"
141
+ ]}
142
+ ```
143
+
144
+ **CORRECT — short phrases, not sentences:**
145
+ ```json
146
+ { "layout": "content", "title": "Current Challenges", "body": [
147
+ "Fragmented customer data across 5 platforms",
148
+ "Manual processes causing 23% error rate",
149
+ "No real-time inventory visibility"
150
+ ]}
151
+ ```
152
+
153
+ Or better — use a visual layout:
154
+ ```json
155
+ { "layout": "stats", "title": "Digital transformation addresses four critical gaps", "stats": [
156
+ { "value": "$2.3M", "label": "Annual inefficiency cost" },
157
+ { "value": "5", "label": "Disconnected platforms" },
158
+ { "value": "23%", "label": "Process error rate" },
159
+ { "value": "0%", "label": "Real-time visibility" }
160
+ ]}
161
+ ```
162
+
163
+ #### Chart and Data Storytelling
164
+
165
+ - **One chart per slide** with a clear title
166
+ - **Label data directly** on the chart, not in a separate legend
167
+ - Include source citation in a caption
168
+
169
+ #### Layout Diversity (Never Repeat)
170
+
171
+ **Never use the same layout type on consecutive slides.** Vary layouts to keep the audience engaged:
172
+
173
+ **Recommended layout sequence for an 8-slide consulting deck:**
174
+ ```
175
+ 1. title — branded opening
176
+ 2. stats — executive summary with 3-4 key metrics
177
+ 3. imageRight — context/background with visual
178
+ 4. comparison — analysis (before/after, options, or categories)
179
+ 5. content — key findings (the ONE text-heavy slide allowed)
180
+ 6. chart (column/line) — data evidence
181
+ 7. stats or timeline — recommendations or roadmap
182
+ 8. closing — call to action
183
+ ```
184
+
185
+ **Layout selection rules:**
186
+ - Max **2 plain `content` slides** per deck (replace others with stats, comparison, timeline, imageRight)
187
+ - Every **3 slides**, include a "visual break" (stats, full image, chart, or big number)
188
+ - **Alternate image sides**: if slide 3 is `imageRight`, slide 6 should be `imageLeft`
189
+ - Use `stats` for metrics/KPIs, `comparison` for options/categories, `timeline` for phases/roadmap
190
+ - The `comparison` layout is underused — use it for before/after, pros/cons, or side-by-side options
191
+
192
+ #### Visual Richness (Defaults, Not Overrides)
193
+
194
+ **These are sensible defaults for when the user hasn't specified exact slide content.** Always prioritize what the user asked for. If they want 3 bullet slides, give them 3 bullet slides.
195
+
196
+ **When the user gives a general request** (e.g., "create a pitch deck about X"), apply these defaults:
197
+ - **At least 2 slides** with `imageRight` or `imageLeft` with a searched/generated image
198
+ - **At least 1 slide** with a chart (column, bar, line, or pie)
199
+ - **At least 1 slide** with `stats` layout for key metrics
200
+ - **No more than 1 plain `content` text-only slide**
201
+ - **Closing slide** should use `closing` layout
202
+
203
+ **When the user specifies exact content** (e.g., "slide 1: intro, slide 2: features list, slide 3: pricing table"), follow their structure exactly. Do not inject charts or stats they didn't ask for.
204
+
205
+ ### Complete 8-Slide JSON Example (Follow This Pattern)
206
+
207
+ ```json
208
+ {
209
+ "options": { "title": "Digital Transformation", "theme": "corporate-elegant", "outputPath": "...", "subject": "business" },
210
+ "slides": [
211
+ { "layout": "title", "title": "Digital Transformation", "subtitle": "Strategic Roadmap for Retail Industry" },
212
+ { "layout": "stats", "title": "Q4 Growth Highlights", "stats": [
213
+ { "value": "$1.2B", "label": "Total Revenue", "change": { "direction": "up", "value": 18 } },
214
+ { "value": "28.5", "suffix": "%", "label": "Profit Margin" },
215
+ { "value": "342+", "label": "Active Customers" },
216
+ { "value": "90", "suffix": " days", "label": "First Results" }
217
+ ]},
218
+ { "layout": "imageRight", "title": "Current Challenges", "body": ["Fragmented customer data", "Manual inventory processes", "No real-time visibility"], "image": { "path": "/searched-image.png" } },
219
+ { "layout": "comparison", "title": "Traditional vs Digital-First", "comparison": { "left": { "title": "Traditional", "points": ["Siloed data", "Manual inventory", "Reactive decisions"] }, "right": { "title": "Digital-First", "points": ["Unified platform", "AI forecasting", "Predictive analytics"] } } },
220
+ { "layout": "chart", "title": "Revenue by Region", "chart": { "type": "column", "data": [{ "name": "Q4 2024", "labels": ["Americas", "EMEA", "APAC"], "values": [520, 320, 395] }, { "name": "Q4 2023", "labels": ["Americas", "EMEA", "APAC"], "values": [450, 295, 310] }] } },
221
+ { "layout": "features", "title": "Strategic Pillars", "columns": [
222
+ { "title": "Customer", "body": ["Personalized journeys", "Omnichannel support"], "icon": "users" },
223
+ { "title": "Operations", "body": ["Automated inventory", "Smart logistics"], "icon": "settings" },
224
+ { "title": "Data", "body": ["Real-time dashboards", "Demand forecasting"], "icon": "bar-chart" },
225
+ { "title": "Technology", "body": ["Cloud infrastructure", "API ecosystem"], "icon": "server" }
226
+ ]},
227
+ { "layout": "timeline", "title": "Implementation Roadmap", "timeline": [
228
+ { "date": "Q1 2026", "title": "Foundation", "description": "Cloud migration, data platform" },
229
+ { "date": "Q2 2026", "title": "Core Systems", "description": "ERP modernization, POS integration" },
230
+ { "date": "Q3 2026", "title": "Intelligence", "description": "AI analytics, personalization" }
231
+ ]},
232
+ { "layout": "closing", "title": "Ready to Transform Your Business?", "subtitle": "Contact us to begin your digital journey" }
233
+ ]
234
+ }
235
+ ```
236
+
237
+ **Key points about this example:**
238
+ - Every slide uses a DIFFERENT layout (title, stats, imageRight, comparison, chart, features, timeline, closing)
239
+ - Titles are clear and concise (not full sentences restating the content)
240
+ - Stats have numeric values with labels and change indicators
241
+ - Image is searched/generated BEFORE building the JSON
242
+ - Chart uses data arrays with named series
243
+ - Features uses 4 columns with icons
244
+ - Body text is concise (under 30 words per slide)
245
+
246
+ **📖 See `windows/examples/10-slide-presentation.md` for another full example with images.**
247
+
248
+ **Key workflow (MANDATORY):**
249
+ 1. **SELECT layouts** — vary every slide, avoid repeating the same layout
250
+ 2. **SEARCH/GENERATE images** for 2-3 slides BEFORE building the JSON
251
+ 3. **BUILD the JSON** with image paths, clear titles, and short body text
252
+ 4. **CHECK** each slide body stays under 30 words (18 for image slides) — split if over
253
+
254
+ ### Available Themes
255
+
256
+ **See "Strategy & Outline → 5. Theme Selection" in SKILL.md for the full theme guide.** Set the `subject` explicitly and use `theme: "auto"` (the generator rotates themes across runs for variety); set an explicit `theme` only when the user names one or for a custom `themePath`.
257
+
258
+ **Built-in themes (18):** dark-professional, ocean-blue, midnight-executive, steel-gray, corporate-elegant, minimal-clean, gradient-modern, nature-inspired, bold-impact, plain-neutral, warm-sunset, arctic-frost, forest-deep, royal-purple, coral-reef, charcoal-ink, sand-stone, electric-neon.
259
+
260
+ #### Classic PowerPoint Themes (Requires Microsoft Office)
261
+
262
+ You can also use **classic PowerPoint themes** by name! These are the themes that come pre-installed with Microsoft Office.
263
+
264
+ | Theme | Theme | Theme | Theme |
265
+ |-------|-------|-------|-------|
266
+ | `ion` | `facet` | `gallery` | `integral` |
267
+ | `slice` | `retrospect` | `organic` | `badge` |
268
+ | `parallax` | `quotable` | `savon` | `wisp` |
269
+ | `banded` | `dividend` | `frame` | `metropolitan` |
270
+ | `berlin` | `celestial` | `circuit` | `damask` |
271
+ | `depth` | `droplet` | `madison` | `main-event` |
272
+ | `mesh` | `parcel` | `view` | `vapor-trail` |
273
+ | `wood-type` | `ion-boardroom` | `feathered` | `basis` |
274
+
275
+ **Usage:** Simply use the theme name with ALL slides in the `slides` array:
276
+ ```json
277
+ {
278
+ "options": {
279
+ "theme": "ion",
280
+ "outputPath": "/path/to/output.pptx"
281
+ },
282
+ "slides": [
283
+ { "layout": "title", "title": "Welcome", "subtitle": "Presentation" },
284
+ { "layout": "content", "title": "Overview", "body": ["Point 1", "Point 2"] }
285
+ ]
286
+ }
287
+ ```
288
+
289
+ **Note:** Classic themes require Microsoft Office to be installed (to locate the `.thmx` files). If not found, you'll get an error with suggestions for built-in themes.
290
+
291
+ **Default behavior:** Classic themes use `full` mode by default, which applies the **actual theme visual design** (triangular patterns, gradients, slide layouts, etc.) - not just colors. The generator creates the themed presentation AND adds all slides via PowerPoint automation in one call.
292
+
293
+ **For colors-only (fast, no visual design):**
294
+ ```json
295
+ {
296
+ "options": {
297
+ "theme": "ion",
298
+ "themeMode": "extract",
299
+ "outputPath": "/path/to/output.pptx"
300
+ },
301
+ "slides": [...]
302
+ }
303
+ ```
304
+ ⚠️ `extract` mode only extracts colors/fonts - you won't get the actual Ion visual design.
305
+
306
+ ---
307
+
308
+ #### Custom Theme from .thmx or .pptx Files
309
+
310
+ You can use your own custom theme from a `.thmx` theme file or extract the theme from an existing `.pptx` presentation.
311
+
312
+ **Two modes available via `themeMode` option:**
313
+
314
+ | Mode | Description | Requires Office? | Slide Layouts |
315
+ |------|-------------|------------------|---------------|
316
+ | `full` (default) | Uses PowerPoint to apply complete theme | ✅ Yes | ✅ Preserved |
317
+ | `extract` | Extracts colors/fonts only, generates directly | ❌ No | ❌ Uses built-in |
318
+
319
+ **Example - Extract mode (fast, no Office needed):**
320
+ ```json
321
+ {
322
+ "options": {
323
+ "themePath": "C:/path/to/custom-theme.thmx",
324
+ "themeMode": "extract",
325
+ "outputPath": "/path/to/output.pptx"
326
+ },
327
+ "slides": [...]
328
+ }
329
+ ```
330
+
331
+ **Example - Full mode with slides (one-step, recommended):**
332
+ ```json
333
+ {
334
+ "options": {
335
+ "themePath": "C:/path/to/custom-theme.thmx",
336
+ "themeMode": "full",
337
+ "outputPath": "/path/to/output.pptx"
338
+ },
339
+ "slides": [
340
+ { "layout": "title", "title": "Welcome", "subtitle": "Presentation" },
341
+ { "layout": "content", "title": "Overview", "body": ["Point 1", "Point 2"] },
342
+ { "layout": "closing", "title": "Thank You" }
343
+ ]
344
+ }
345
+ ```
346
+ Include ALL slides in the `slides` array — the generator creates the themed presentation with all content in one call.
347
+
348
+ **Extracting theme from existing presentations:**
349
+ ```json
350
+ {
351
+ "options": {
352
+ "themePath": "C:/path/to/existing-presentation.pptx",
353
+ "themeMode": "extract",
354
+ "outputPath": "/path/to/new-presentation.pptx"
355
+ },
356
+ "slides": [...]
357
+ }
358
+ ```
359
+
360
+ **What the theme parser extracts:**
361
+ - **Colors:** Primary, secondary, background, text, accent colors (1-4)
362
+ - **Fonts:** Title font (major), body font (minor)
363
+ - **Mode detection:** Automatically detects light/dark mode based on background luminance
364
+
365
+
366
+ ---
367
+
368
+ #### Stats Object Format
369
+
370
+ Each stat in the `stats[]` array:
371
+ ```json
372
+ { "value": 75, "label": "Customer Satisfaction", "suffix": "%" }
373
+ ```
374
+
375
+ | Field | Required | Description |
376
+ |-------|----------|-------------|
377
+ | `value` | Yes | Number or string (e.g., `75`, `"1.2"`) |
378
+ | `label` | Yes | Short description below the number |
379
+ | `prefix` | No | Text before value (e.g., `"$"`) |
380
+ | `suffix` | No | Text after value (e.g., `"%"`, `"M"`, `"+"`) |
381
+ | `change` | No | `{ "value": 12, "direction": "up" }` — shows trend arrow |
382
+
383
+ **Percentage circles:** Stats with `suffix: "%"` automatically render as visual progress rings (colored arc showing the proportion filled). Use this for data that genuinely represents a percentage (0-100) like satisfaction rates, completion rates, market share, growth percentages.
384
+
385
+ **When NOT to use `suffix: "%"`:**
386
+ - Counts or quantities (use no suffix or `"+"`)
387
+ - Currency (use `prefix: "$"`)
388
+ - Large numbers (use `suffix: "M"` or `"K"`)
389
+ - Don't force `%` on non-percentage data just for visual effect — mix plain text stats with percentage circles for the best-looking slides
390
+
391
+ ### Icons in Slides (Optional Enhancement)
392
+
393
+ The generator supports **react-icons** for visual richness. Icons render as images embedded directly in the slide — no fonts or plugins required.
394
+
395
+ **Supported icon sets:** `Fa`/`Fa6` (Font Awesome), `Md` (Material Design), `Io`/`Io5` (Ionicons), `Fi` (Feather), `Bs` (Bootstrap), `Hi`/`Hi2` (Heroicons), `Ri` (Remix), `Lu` (Lucide), `Tb` (Tabler), `Bi` (BoxIcons), `Ai` (Ant Design), `Gi` (Game Icons), `Wi` (Weather Icons), `Pi` (Phosphor), `Ci`, `Go` (Octicons), `Gr` (Grommet), `Im` (IcoMoon), `Si` (Simple Icons), `Sl` (Simple Line), `Ti` (Typicons), `Vsc` (VS Code), `Cg` (css.gg), `Tfi` (Themify), `Lia` (Line Awesome).
396
+
397
+ **Where icons work:**
398
+
399
+ | Layout | Field | Effect |
400
+ |--------|-------|--------|
401
+ | `content` | `body` as `BulletItem[]` | Icon replaces bullet character |
402
+ | `twoColumn` | `columns[].icon` | Icon centered above column title |
403
+ | `stats` | `stats[].icon` | Icon above the stat value |
404
+ | `timeline` | `timeline.items[].icon` | Icon replaces timeline dot |
405
+ | `features` | `columns[].icon` | Icon in colored circle on each feature card |
406
+
407
+ **Content slide with icon bullets:**
408
+ ```json
409
+ {
410
+ "layout": "content",
411
+ "title": "Our Services",
412
+ "body": [
413
+ { "text": "Cloud Infrastructure", "icon": "FaCloud" },
414
+ { "text": "Security & Compliance", "icon": "FaShieldAlt" },
415
+ { "text": "24/7 Support", "icon": "FaHeadset" }
416
+ ]
417
+ }
418
+ ```
419
+
420
+ **Features slide with icon cards:**
421
+ ```json
422
+ {
423
+ "layout": "features",
424
+ "title": "Why Choose Us",
425
+ "columns": [
426
+ { "title": "Fast Deployment", "body": "Get up and running in minutes with our streamlined setup process", "icon": "FaRocket" },
427
+ { "title": "Enterprise Security", "body": "Bank-grade encryption and compliance with SOC2 and ISO 27001", "icon": "FaShieldAlt" },
428
+ { "title": "24/7 Support", "body": "Round-the-clock expert support with guaranteed response times", "icon": "FaHeadset" },
429
+ { "title": "Scalability", "body": "Seamlessly scale from startup to enterprise with zero downtime", "icon": "FaExpand" }
430
+ ]
431
+ }
432
+ ```
433
+
434
+ **Stats with icons:**
435
+ ```json
436
+ {
437
+ "layout": "stats",
438
+ "title": "Key Metrics",
439
+ "stats": [
440
+ { "value": 99.9, "label": "Uptime", "suffix": "%", "icon": "FaServer" },
441
+ { "value": 50, "label": "Countries", "suffix": "+", "icon": "FaGlobe" }
442
+ ]
443
+ }
444
+ ```
445
+
446
+ **Timeline with icons:**
447
+ ```json
448
+ {
449
+ "layout": "timeline",
450
+ "title": "Our Journey",
451
+ "timeline": {
452
+ "items": [
453
+ { "date": "2020", "title": "Founded", "icon": "FaRocket" },
454
+ { "date": "2022", "title": "Series A", "icon": "FaChartLine" },
455
+ { "date": "2024", "title": "Global Launch", "icon": "FaGlobeAmericas" }
456
+ ]
457
+ }
458
+ }
459
+ ```
460
+
461
+ **Guidelines:**
462
+ - **Prefer icons over plain bullets/dots** on `timeline`, `features`, `stats`, and `content` slides — they add visual polish and make slides more engaging. Only omit icons when no suitable icon exists for the concept.
463
+ - Pick icons from the same set (e.g., all `Fa*`) for consistency
464
+ - Plain `body: ["Point 1", "Point 2"]` still works as a fallback when icons don't fit the content
465
+ - If an icon name is invalid, the slide falls back to default bullets/dots gracefully
466
+
467
+ ---
468
+
469
+ ### Chart Data Format
470
+
471
+ For `chart` layout slides, use this format:
472
+
473
+ ```json
474
+ {
475
+ "layout": "chart",
476
+ "title": "Sales Performance",
477
+ "chart": {
478
+ "type": "bar",
479
+ "title": "Monthly Sales",
480
+ "data": [
481
+ {
482
+ "name": "2024 Sales",
483
+ "labels": ["Jan", "Feb", "Mar", "Apr"],
484
+ "values": [100, 150, 200, 175]
485
+ },
486
+ {
487
+ "name": "2023 Sales",
488
+ "labels": ["Jan", "Feb", "Mar", "Apr"],
489
+ "values": [80, 120, 160, 140]
490
+ }
491
+ ],
492
+ "showLegend": true,
493
+ "showValues": false,
494
+ "showGrid": true
495
+ }
496
+ }
497
+ ```
498
+
499
+ **Chart Types:** `bar`, `column`, `line`, `pie`, `doughnut`, `area`, `scatter`
500
+
501
+ **Chart Fields:** `type` (required), `data[]` or `categories`+`series` (required), `title`, `showLegend`, `showValues`, `showGrid` (all optional booleans/string).
502
+
503
+ **Alternative Format (also supported):**
504
+ ```json
505
+ {
506
+ "layout": "chart",
507
+ "title": "Market Share",
508
+ "chart": {
509
+ "type": "pie",
510
+ "title": "Market Distribution",
511
+ "categories": ["Company A", "Company B", "Others"],
512
+ "series": [
513
+ { "name": "Market Share", "values": [45, 35, 20] }
514
+ ]
515
+ }
516
+ }
517
+ ```
518
+
519
+ ### Table Data Format
520
+
521
+ For `table` layout slides, use this format:
522
+
523
+ ```json
524
+ {
525
+ "layout": "table",
526
+ "title": "Regional Performance",
527
+ "table": {
528
+ "headers": ["Region", "Revenue", "Growth %", "Target Achievement"],
529
+ "rows": [
530
+ ["North", "$2.5M", "+12%", "105%"],
531
+ ["South", "$1.8M", "+8%", "98%"],
532
+ ["East", "$3.1M", "+15%", "112%"],
533
+ ["West", "$2.2M", "+10%", "101%"]
534
+ ],
535
+ "columnWidths": [2, 1.5, 1, 1.5]
536
+ }
537
+ }
538
+ ```
539
+
540
+ **Table Fields:**
541
+ - `headers` (optional): Array of column header strings - displayed in bold with primary color background
542
+ - `rows` (required): 2D array of cell values (strings or numbers)
543
+ - `columnWidths` (optional): Array of relative column widths in inches
544
+ - **Long tables:** a table with more than 9 rows plus headers still goes on one slide: it spans the full content width (your `columnWidths` are scaled to it), its rows share the slide height (15 rows ≈ 0.35" each) and its font shrinks, down to 9 pt. Each cell must then fit in about 2 lines, roughly 14 characters per inch of column width per line. If the text still does not fit, the generation result gives each column's character limit: shorten those cells in your one corrective rebuild, or split the table across slides.
545
+
546
+ **Example with numeric data:**
547
+ ```json
548
+ {
549
+ "layout": "table",
550
+ "title": "Q4 Sales by Product",
551
+ "table": {
552
+ "headers": ["Product", "Units Sold", "Revenue ($M)", "Margin %"],
553
+ "rows": [
554
+ ["Product A", 15000, 4.5, 32],
555
+ ["Product B", 12000, 3.2, 28],
556
+ ["Product C", 8500, 2.1, 35],
557
+ ["Product D", 6000, 1.8, 40]
558
+ ]
559
+ }
560
+ }
561
+ ```
562
+
563
+ ---
564
+
565
+ ### Diagram Format
566
+
567
+ Renders a diagram as a high-resolution image on the slide. Uses diagram definition syntax (flowcharts, sequences, state machines, ER diagrams, etc.).
568
+
569
+ ```json
570
+ {
571
+ "layout": "diagram",
572
+ "title": "System Architecture",
573
+ "diagram": {
574
+ "code": "graph TD\n A[Web Client] --> B[API Gateway]\n B --> C[Auth Service]\n B --> D[Core Service]\n D --> E[(Database)]",
575
+ "caption": "High-level system architecture"
576
+ }
577
+ }
578
+ ```
579
+
580
+ **DiagramContent fields:**
581
+
582
+ | Field | Type | Required | Description |
583
+ |-------|------|----------|-------------|
584
+ | `code` | string | Yes | Diagram definition (flowchart, sequence, etc.) |
585
+ | `caption` | string | No | Caption text below the diagram |
586
+
587
+ **Supported diagram types:** `graph`/`flowchart`, `sequenceDiagram`, `stateDiagram-v2`, `classDiagram`, `erDiagram`, `gantt`, `mindmap`, `timeline`
588
+
589
+ **Tips:** Keep labels short (3-5 words), limit to 8-12 nodes, use subgraphs to group components. Colors inherit from the presentation theme.
590
+
591
+ ---
592
+
593
+ ### Comparison Format
594
+
595
+ ```json
596
+ {
597
+ "layout": "comparison",
598
+ "title": "Fairy Friends & Enemies",
599
+ "comparison": {
600
+ "left": {
601
+ "title": "Fairy Friends",
602
+ "points": ["Butterflies and ladybugs", "Fireflies", "Rabbits and deer", "Singing birds", "Friendly gnomes"]
603
+ },
604
+ "right": {
605
+ "title": "Fairy Foes",
606
+ "points": ["Grumpy trolls", "Mischievous goblins", "Forest litterers", "Shadow sprites"]
607
+ }
608
+ }
609
+ }
610
+ ```
611
+
612
+ **Each `points` array MUST have 3-6 short, distinct items.** Never collapse a list into one long sentence — each point should be a separate array element.
613
+
614
+ **Comparison Fields:** `left`/`right` (required), each `{ title, points[], highlight? }` — set `highlight: true` on the winning/recommended side to accent it visually. `vsLabel` (optional, top-level, default `"VS"`) — the label shown between the two sides, e.g. `"OR"`, `"THEN"`.
615
+
616
+ ---
617
+
618
+ ### Timeline Format
619
+
620
+ `timeline` accepts either a bare array of items, or the nested `{ items, orientation }` form — both are equivalent:
621
+
622
+ ```json
623
+ // Bare array (orientation defaults to horizontal)
624
+ { "layout": "timeline", "title": "Rollout Plan", "timeline": [
625
+ { "date": "Q1", "title": "Discovery", "description": "Requirements gathering", "icon": "FaSearch" },
626
+ { "date": "Q2", "title": "Build", "description": "Core implementation", "icon": "FaHammer" }
627
+ ]}
628
+
629
+ // Nested form (explicit orientation)
630
+ { "layout": "timeline", "title": "Rollout Plan", "timeline": {
631
+ "items": [
632
+ { "date": "Q1", "title": "Discovery", "icon": "FaSearch" },
633
+ { "date": "Q2", "title": "Build", "icon": "FaHammer" }
634
+ ],
635
+ "orientation": "vertical"
636
+ }}
637
+ ```
638
+
639
+ **Timeline Fields:** each item needs `date`, `title` (required), `description`/`icon` (optional). `orientation` (`'horizontal'`/`'vertical'`, default horizontal) only applies in the nested form. Max 4 phases per slide (see rule 6 above).
640
+
641
+ ---
642
+
643
+ ### Team Format
644
+
645
+ ```json
646
+ {
647
+ "layout": "team",
648
+ "title": "Meet the Team",
649
+ "team": [
650
+ { "name": "Alex Rivera", "role": "Engineering Lead", "bio": "10 years in distributed systems", "image": { "path": "/alex.png" } },
651
+ { "name": "Priya Shah", "role": "Product Manager" }
652
+ ]
653
+ }
654
+ ```
655
+
656
+ **TeamMember Fields:** `name` (required), `role`/`bio`/`image` (optional). `image` uses the same `path`/`url`/`base64` format as any other image (see "Image Format" below).
657
+
658
+ ---
659
+
660
+ ### Image Format
661
+
662
+ Every `image`/`images[]` field (on `imageLeft`/`imageRight`/`imageFull`, `quote.image`, `team[].image`) accepts:
663
+
664
+ ```json
665
+ { "path": "/local/searched-image.png", "sizing": "cover", "position": "right", "alt": "Team collaborating", "caption": "Our team in action" }
666
+ ```
667
+
668
+ **Image Fields:** exactly one of `path` (local file, preferred), `url`, or `base64` (required); `sizing` (`'contain'`/`'cover'`/`'stretch'`), `position` (`'left'`/`'right'`/`'center'`/`'full'`/`'background'`), `alt`, `caption` — all optional. `imageFull` and `blank` slides commonly use `position: "full"` or `"background"`.