@uipath/delegate-sdk 1.203.1 → 1.203.3

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 +729 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +444 -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 +224 -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 +88 -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,458 @@
1
+ # PowerPoint Architect - Windows API Reference
2
+
3
+ Windows-specific PowerPoint automation via **ExecuteSkillApi** endpoints and **C# scripting**.
4
+
5
+ ## Execution Priority (Windows)
6
+
7
+ | Priority | Approach | Tool | Speed | Best For |
8
+ |----------|----------|------|-------|----------|
9
+ | **1st** | API | ExecuteSkillApi | Fastest | Slides, text, images, tables, charts |
10
+ | **2nd** | C# Script | `/ppt/execute-script` | Fast | Complex logic, custom automation |
11
+ | **3rd** | UIA | AppAct | Slowest | Ribbon clicks, dialogs, animations |
12
+
13
+ If the user forbids arbitrary Office scripts, never call `/ppt/execute-script`. Use structured `/ppt/*` endpoints or report the limitation.
14
+
15
+ ---
16
+
17
+ ## Quick Reference
18
+
19
+ ### Creation (New Presentation)
20
+ | Task | Endpoint | Key Parameters |
21
+ |------|----------|----------------|
22
+ | Generate new presentation | `/ppt-gen/generate` | options (title, theme/themePath, outputPath), slides |
23
+ | List generator themes | `/ppt-gen/list-themes` | - |
24
+ | Render Mermaid diagram to PNG | `/diagram/render-mermaid` | code, outputPath |
25
+
26
+ **Note:** `/ppt-gen/*` creates presentations from scratch (no PowerPoint needed). `/ppt/*` (below) drives an already-open PowerPoint window for editing. Do NOT use `/ppt/generate` or `/ppt/create-presentation` — those endpoints do not exist. See `generator-reference.md` for the `/ppt-gen/generate` JSON format.
27
+
28
+ ### Lifecycle Operations
29
+ | Task | Endpoint | Key Parameters |
30
+ |------|----------|----------------|
31
+ | Open/attach presentation | `/ppt/open-attach` | filePath, createNew, visible (default false = windowless) |
32
+ | Close presentation | `/ppt/close` | filePath |
33
+ | Get presentation info | `/ppt/get-presentation-info` | filePath |
34
+ | Get opened files | `/ppt/get-opened-files` | - |
35
+ | Get recent files | `/ppt/get-recent-files` | - |
36
+ | Save as PDF | `/ppt/save-as-pdf` | filePath, pdfFilePath |
37
+
38
+ ### Slide Operations
39
+ | Task | Endpoint | Key Parameters |
40
+ |------|----------|----------------|
41
+ | Insert slide | `/ppt/insert-slide` | filePath, position, slideLayout |
42
+ | Select slide | `/ppt/select-slide` | filePath, slideNumber. **Needs `visible: true` on open** |
43
+ | Delete slide | `/ppt/delete-slide` | filePath, slideNumber |
44
+ | Duplicate slides | `/ppt/duplicate-slides` | filePath, startSlideNumber, count |
45
+ | Reorder/move slide | `/ppt/reorder-slide` | filePath, slideNumber, newPosition |
46
+ | Copy slides | `/ppt/copy-slides` | sourceFilePath, targetFilePath, startSlideNumber, endSlideNumber |
47
+ | Get current slide | `/ppt/get-current-slide-number` | filePath |
48
+
49
+ ### Content Operations
50
+ | Task | Endpoint | Key Parameters |
51
+ |------|----------|----------------|
52
+ | Add text to slide | `/ppt/add-text-to-slide` | filePath, slideNumber, targetShapeName, text |
53
+ | Add speaker notes | `/ppt/add-speaker-notes` | filePath, slideNumber, notes |
54
+ | Replace text | `/ppt/replace-text` | filePath, oldText, newText |
55
+ | Insert image | `/ppt/insert-image` | filePath, slideNumber, imagePath |
56
+ | Replace image | `/ppt/replace-image` | filePath, slideNumber, imagePath, targetShapeName |
57
+ | Insert table | `/ppt/insert-table` | filePath, slideNumber, table |
58
+ | Insert chart | `/ppt/insert-chart` | filePath, slideNumber, chartType, categories, series |
59
+
60
+ ### Analysis Operations
61
+ | Task | Endpoint | Key Parameters |
62
+ |------|----------|----------------|
63
+ | Analyze slide content | `/ppt/analyze-slide-content` | filePath, slideNumbers |
64
+ | Review slides | `/ppt/review-slides` | filePath, slideNumbers, checks |
65
+ | Extract slide data | `/ppt/extract-slide-data` | filePath, slideNumber |
66
+
67
+ ### Formatting Operations
68
+ | Task | Endpoint | Key Parameters |
69
+ |------|----------|----------------|
70
+ | Format slide content | `/ppt/format-slide-content` | filePath, slideNumbers, shapeName, textMatch, fontSize, bold |
71
+ | Format shape | `/ppt/format-shape` | filePath, slideNumber, shapeName, left, top |
72
+ | Optimize slide | `/ppt/optimize-slide` | filePath, slideNumber |
73
+ | Apply theme (editing only!) | `/ppt/apply-theme` | filePath, themeName or themeFilePath |
74
+
75
+ ### Scripting
76
+ | Task | Endpoint | Key Parameters |
77
+ |------|----------|----------------|
78
+ | Execute C# script | `/ppt/execute-script` | filePath, script, slideNumber |
79
+
80
+ ---
81
+
82
+ ## Critical Rules
83
+
84
+ | Rule | Description |
85
+ |------|-------------|
86
+ | **Open first** | Always call `/ppt/open-attach` before any operation |
87
+ | **Analyze before edit** | Always call `/ppt/analyze-slide-content` to get shape names |
88
+ | **Use exact shape names** | Copy existing shape names exactly from analyze response. If a new slide returns `shapes: []`, use the zero-shape recovery below. |
89
+ | **Extract via API** | Use `/ppt/extract-slide-data` for tables/text/charts - NEVER scripts |
90
+ | **clearExistingText: true** | When replacing content, ALWAYS use `clearExistingText: true` to prevent doubling |
91
+ | **Health check + fix** | Run `/ppt/review-slides` and fix its warnings in one pass before declaring success; report what remains (SKILL.md Core Principle 4) |
92
+ | **Shape names are case-sensitive** | "Title 1" != "title 1" |
93
+ | **Slide numbers are 1-based** | First slide = 1, not 0 |
94
+ | **Auto-save enabled** | Changes save automatically, no explicit save needed |
95
+
96
+ ---
97
+
98
+ ## SharePoint / OneDrive Files
99
+
100
+ To open a file from SharePoint or OneDrive, use PowerShell — **never download via HTTP** (auth will fail) or click through browser UI:
101
+
102
+ ```
103
+ ExecutePowershellCommand: Start-Process "POWERPNT.EXE" -ArgumentList "/o `"<url>`""
104
+ ```
105
+
106
+ Get the URL from the **browser address bar** — do not construct it yourself. Then call `/ppt/get-opened-files` to confirm it loaded. The returned `filePath` will be a URL — use it as-is in all `/ppt/*` endpoints (`filePath`, `sourceFilePath`, etc.).
107
+
108
+ ### Copy slides from SharePoint to local file
109
+ ```json
110
+ // 1. Open SharePoint file via PowerShell (get URL from browser)
111
+ // 2. Create local target
112
+ { "endpoint": "/ppt/open-attach", "body": { "filePath": "C:\\Users\\me\\Documents\\Copy.pptx", "createNew": true } }
113
+ // 3. Copy slides using startSlideNumber + endSlideNumber (NOT "count" or "slideNumbers")
114
+ { "endpoint": "/ppt/copy-slides", "body": {
115
+ "sourceFilePath": "https://company.sharepoint.com/.../file.pptx",
116
+ "targetFilePath": "C:\\Users\\me\\Documents\\Copy.pptx",
117
+ "startSlideNumber": 1,
118
+ "endSlideNumber": 3
119
+ } }
120
+ ```
121
+
122
+ ---
123
+
124
+ ## Discovery-First Workflow
125
+
126
+ Before editing, ALWAYS discover the presentation structure:
127
+
128
+ ```
129
+ 1. Open/Attach -> Get file reference and slide list
130
+ 2. Analyze -> Get shape names and layout for target slide(s)
131
+ 3. Plan -> Determine what changes to make
132
+ 4. Execute -> Perform operations using exact shape names
133
+ 5. Health Check -> Run /ppt/review-slides to verify quality
134
+ ```
135
+
136
+ ---
137
+
138
+ ## Common Patterns
139
+
140
+ ### Open and Analyze Presentation
141
+ ```json
142
+ // Step 1: Open
143
+ {
144
+ "endpoint": "/ppt/open-attach",
145
+ "body": {
146
+ "filePath": "C:/Users/me/Documents/presentation.pptx"
147
+ }
148
+ }
149
+ // Response: { "success": true, "filePath": "...", "slides": [...], "totalSlides": 10 }
150
+
151
+ // Step 2: Analyze specific slides
152
+ {
153
+ "endpoint": "/ppt/analyze-slide-content",
154
+ "body": {
155
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
156
+ "slideNumbers": [1, 2, 3]
157
+ }
158
+ }
159
+ // Response includes shape names: ["Title 1", "Content Placeholder 2", ...]
160
+ ```
161
+
162
+ ### Add Content to Existing Slide
163
+ ```json
164
+ // Use shape names from analyze response
165
+ {
166
+ "endpoint": "/ppt/add-text-to-slide",
167
+ "body": {
168
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
169
+ "slideNumber": 2,
170
+ "targetShapeName": "Content Placeholder 2",
171
+ "text": "- Point 1\n- Point 2\n- Point 3",
172
+ "clearExistingText": true
173
+ }
174
+ }
175
+ ```
176
+
177
+ ### Insert New Slide with Content
178
+ ```json
179
+ // Step 1: Insert slide
180
+ {
181
+ "endpoint": "/ppt/insert-slide",
182
+ "body": {
183
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
184
+ "position": 4,
185
+ "slideLayout": "Title and Content"
186
+ }
187
+ }
188
+ // Response includes available shapes for the new slide.
189
+ // If the response has shapes: [], use the Windows zero-shape recovery below.
190
+
191
+ // Step 2: Add title
192
+ {
193
+ "endpoint": "/ppt/add-text-to-slide",
194
+ "body": {
195
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
196
+ "slideNumber": 4,
197
+ "targetShapeName": "Title 1",
198
+ "text": "New Section Title"
199
+ }
200
+ }
201
+
202
+ // Step 3: Add body content
203
+ {
204
+ "endpoint": "/ppt/add-text-to-slide",
205
+ "body": {
206
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
207
+ "slideNumber": 4,
208
+ "targetShapeName": "Content Placeholder 2",
209
+ "text": "- Key point 1\n- Key point 2\n- Key point 3"
210
+ }
211
+ }
212
+
213
+ // Step 4: Health check
214
+ {
215
+ "endpoint": "/ppt/review-slides",
216
+ "body": {
217
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
218
+ "slideNumbers": [4]
219
+ }
220
+ }
221
+ ```
222
+
223
+ **Windows zero-shape recovery:** If `/ppt/insert-slide` returns `shapes: []`, call `/ppt/add-text-to-slide` with a deterministic new `targetShapeName`, such as `DelegateTextBox`. On Windows, a missing target shape makes this structured endpoint auto-create the text box and persist the presentation.
224
+
225
+ ```json
226
+ {
227
+ "endpoint": "/ppt/add-text-to-slide",
228
+ "body": {
229
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
230
+ "slideNumber": 4,
231
+ "targetShapeName": "DelegateTextBox",
232
+ "text": "New slide content"
233
+ }
234
+ }
235
+ ```
236
+
237
+ Do not use `/ppt/execute-script` for zero-shape recovery. Do not call the nonexistent Windows `/ppt/save-presentation` endpoint or script `Save()`; structured native mutations auto-save.
238
+
239
+ ### Health Check (Run After Every Edit)
240
+ ```json
241
+ // Review all slides for issues
242
+ {
243
+ "endpoint": "/ppt/review-slides",
244
+ "body": {
245
+ "filePath": "C:/Users/me/Documents/presentation.pptx"
246
+ }
247
+ }
248
+ // Response includes: summary (issues, warnings, critical), per-slide issues, recommendations
249
+
250
+ // Review specific slides only
251
+ {
252
+ "endpoint": "/ppt/review-slides",
253
+ "body": {
254
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
255
+ "slideNumbers": [2, 3, 4]
256
+ }
257
+ }
258
+ ```
259
+
260
+ ### Insert Table
261
+ ```json
262
+ {
263
+ "endpoint": "/ppt/insert-table",
264
+ "body": {
265
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
266
+ "slideNumber": 3,
267
+ "table": [
268
+ ["Header 1", "Header 2", "Header 3"],
269
+ ["Row 1 A", "Row 1 B", "Row 1 C"],
270
+ ["Row 2 A", "Row 2 B", "Row 2 C"]
271
+ ]
272
+ }
273
+ }
274
+ ```
275
+
276
+ ### Insert Chart
277
+ ```json
278
+ {
279
+ "endpoint": "/ppt/insert-chart",
280
+ "body": {
281
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
282
+ "slideNumber": 5,
283
+ "chartType": "Column",
284
+ "chartTitle": "Quarterly Sales",
285
+ "categories": ["Q1", "Q2", "Q3", "Q4"],
286
+ "series": [
287
+ { "name": "2023", "values": [100, 150, 200, 175] },
288
+ { "name": "2024", "values": [120, 180, 220, 210] }
289
+ ]
290
+ }
291
+ }
292
+ ```
293
+
294
+ ### Insert Image
295
+
296
+ **⚠️ ALWAYS use `targetShapeName` - omitting it causes overlapping!**
297
+
298
+ ```json
299
+ // 1. Analyze slide to get placeholder name
300
+ {"endpoint": "/ppt/analyze-slide-content", "body": {"filePath": "...", "slideNumbers": [3]}}
301
+ // → Returns: "Picture Placeholder 2" or "Content Placeholder 2"
302
+
303
+ // 2. Insert image INTO placeholder
304
+ {"endpoint": "/ppt/insert-image", "body": {
305
+ "filePath": "...",
306
+ "slideNumber": 3,
307
+ "imagePath": "C:/path/to/image.png",
308
+ "targetShapeName": "Picture Placeholder 2"
309
+ }}
310
+ ```
311
+
312
+ **Image-friendly layouts:** `Picture with Caption`, `Title and Content`, `Two Content`
313
+
314
+ ### Format Text
315
+
316
+ **Whole shape** — formats all text in the shape:
317
+ ```json
318
+ {
319
+ "endpoint": "/ppt/format-slide-content",
320
+ "body": {
321
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
322
+ "slideNumbers": [1],
323
+ "shapeName": "Title 1",
324
+ "fontSize": 44,
325
+ "bold": true,
326
+ "fontColor": "#003366"
327
+ }
328
+ }
329
+ ```
330
+
331
+ **Targeted text** — formats only the matched text (use for sub-headers, keywords, highlights):
332
+ ```json
333
+ {
334
+ "endpoint": "/ppt/format-slide-content",
335
+ "body": {
336
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
337
+ "slideNumbers": [13],
338
+ "shapeName": "Text Placeholder 2",
339
+ "textMatch": "Key Features:",
340
+ "bold": true,
341
+ "fontSize": 20
342
+ }
343
+ }
344
+ ```
345
+ `textMatch` finds all occurrences of the exact text (case-insensitive) and applies formatting only to those characters. Use this to bold sub-headers like "Key Features:", highlight keywords, or change the color of specific phrases without affecting the rest of the shape.
346
+
347
+ ### Apply Theme (EDITING ONLY)
348
+
349
+ **⚠️ For CREATING new presentations with a custom theme, use `themePath` in the generator JSON options instead! This API is only for changing themes on EXISTING presentations.**
350
+
351
+ ```json
352
+ // From built-in theme name
353
+ {
354
+ "endpoint": "/ppt/apply-theme",
355
+ "body": {
356
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
357
+ "themeName": "Office Theme"
358
+ }
359
+ }
360
+
361
+ // From custom .thmx file
362
+ {
363
+ "endpoint": "/ppt/apply-theme",
364
+ "body": {
365
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
366
+ "themeFilePath": "C:/Themes/Corporate.thmx"
367
+ }
368
+ }
369
+ ```
370
+
371
+ ---
372
+
373
+ ## Available Slide Layouts
374
+
375
+ When using `/ppt/insert-slide`, specify one of these layout names:
376
+
377
+ | Layout Name | Description |
378
+ |-------------|-------------|
379
+ | Title Slide | Title + subtitle centered |
380
+ | Title and Content | Title + content placeholder |
381
+ | Section Header | Section title |
382
+ | Two Content | Title + two side columns |
383
+ | Comparison | Title + two columns with headers |
384
+ | Title Only | Just title |
385
+ | Blank | Empty slide |
386
+ | Content with Caption | Content + side caption |
387
+ | Picture with Caption | Large picture + caption |
388
+
389
+ ---
390
+
391
+ ## Documentation (Load When Needed)
392
+
393
+ ### Workflow Examples
394
+ | File | Content | When to Load |
395
+ |------|---------|--------------|
396
+ | `windows/examples/level-1-workflows.md` | End-to-end workflow patterns | Learning common patterns |
397
+ | `windows/examples/level-2-scripting.md` | C# scripting patterns | When API endpoints are insufficient |
398
+
399
+ ### API Schemas
400
+ | File | Endpoints | When to Load |
401
+ |------|-----------|--------------|
402
+ | `windows/api/basic.md` | Lifecycle, slides, content | Essential operations |
403
+ | `windows/api/advanced.md` | Formatting, charts, tables, themes | Advanced operations |
404
+
405
+ ### Issue Fixing Reference
406
+ | File | Content | When to Load |
407
+ |------|---------|--------------|
408
+ | `issue-fix-mapping.md` | Fix patterns for ALL health check issues | **When fixing health check warnings** |
409
+
410
+ ---
411
+
412
+ ## Troubleshooting
413
+
414
+ | Error | Cause | Solution |
415
+ |-------|-------|----------|
416
+ | `Shape not found` | Wrong shape name | Run `/ppt/analyze-slide-content` to get exact names |
417
+ | `No active presentation` | File not open | Call `/ppt/open-attach` first |
418
+ | `Slide not found` | Invalid slide number | Slide numbers are 1-based (first slide = 1) |
419
+ | `File already exists` | Output path exists (generator) | Use different filename or delete existing |
420
+ | `PowerPoint not running` | Application not started | `/ppt/open-attach` will start PowerPoint |
421
+
422
+ ### Chart Text Colors on Dark Themes (Auto-Fixed)
423
+
424
+ **Good news:** The `/ppt/insert-chart` endpoint now **automatically detects** the slide background color and applies appropriate contrasting text colors to chart elements (legend, title, axis labels).
425
+
426
+ - **Dark backgrounds** (luminance < 50%): White text is applied
427
+ - **Light backgrounds** (luminance >= 50%): Black text is applied
428
+
429
+ This means you no longer need to manually fix chart colors. Just insert the chart and run the health check:
430
+
431
+ ```
432
+ 1. `/ppt/insert-chart` - Insert the chart (colors auto-adjusted)
433
+ 2. `/ppt/review-slides` - Verify visibility
434
+ ```
435
+
436
+ **Note:** If you need to manually override chart colors for any reason, you can still use `/ppt/execute-script` with custom C# code.
437
+
438
+ ### Modifying Chart Data via Script
439
+
440
+ Use `/ppt/execute-script` to modify chart data after a chart has been created:
441
+
442
+ ```json
443
+ {
444
+ "endpoint": "/ppt/execute-script",
445
+ "body": {
446
+ "filePath": "C:/Users/me/Documents/presentation.pptx",
447
+ "slideNumber": 5,
448
+ "script": "// Find chart shape and modify data\nforeach (dynamic shape in slide.Shapes) {\n if (shape.HasChart == MsoTriState.msoTrue) {\n dynamic wb = shape.Chart.ChartData.Workbook;\n dynamic ws = wb.Worksheets[1];\n ws.Cells[2, 1].Value = \"New Category Name\";\n ws.Cells[2, 2].Value = 150; // Update value\n shape.Chart.Refresh();\n break;\n }\n}\nreturn \"Chart data updated\";"
449
+ }
450
+ }
451
+ ```
452
+
453
+ **Key points for chart data scripts:**
454
+ - Chart data is stored in an embedded Excel workbook accessed via `shape.Chart.ChartData.Workbook`
455
+ - Use `dynamic` type for all COM objects (script runner auto-converts `var` to `dynamic` for chart objects)
456
+ - Row 1 contains series headers, column A contains category labels
457
+ - Call `chart.Refresh()` after modifying data to update the visual
458
+ - Available namespaces: `Microsoft.Office.Interop.PowerPoint`, `Microsoft.Office.Interop.Excel`, `Microsoft.Office.Core`
@@ -0,0 +1,141 @@
1
+ # Custom Theme Workflow (.thmx / .pptx)
2
+
3
+ **When user provides a `.thmx` or `.pptx` file as theme source, use the Generator with `themePath`.**
4
+
5
+ ---
6
+
7
+ ## Single-Step Process (Generator handles everything)
8
+
9
+ **The Generator creates ALL slides with ALL content in ONE call when using `themePath`.** Include every slide in the `slides` array — the Generator applies the theme and generates all slides at once.
10
+
11
+ ```json
12
+ {
13
+ "options": {
14
+ "title": "My Presentation",
15
+ "themePath": "/path/to/Theme1.thmx",
16
+ "themeMode": "full",
17
+ "outputPath": "/path/to/output.pptx",
18
+ "subject": "tech"
19
+ },
20
+ "slides": [
21
+ { "layout": "title", "title": "Welcome", "subtitle": "Introduction" },
22
+ { "layout": "content", "title": "Key Points", "body": ["Point 1", "Point 2", "Point 3"] },
23
+ { "layout": "stats", "title": "Key Metrics", "stats": [{"value": "95", "suffix": "%", "label": "Success Rate"}] },
24
+ { "layout": "imageRight", "title": "Visual", "body": ["Detail 1", "Detail 2"], "image": {"path": "/path/to/image.png"} },
25
+ { "layout": "closing", "title": "Thank You", "subtitle": "Questions?" }
26
+ ]
27
+ }
28
+ ```
29
+
30
+ **🚨 FORBIDDEN — NEVER do this:**
31
+ ```json
32
+ // ❌ WRONG: Empty slides array, then add slides via API one by one
33
+ {
34
+ "options": { "themePath": "...", "outputPath": "..." },
35
+ "slides": []
36
+ }
37
+ // Then /ppt/insert-slide → /ppt/add-text-to-slide → repeat = WRONG
38
+ ```
39
+
40
+ **After generation:** `/ppt/open-attach` → `/ppt/review-slides` → offer an `Agent` review (SKILL.md Core Principle 4).
41
+
42
+ ---
43
+
44
+ ## themeMode Options
45
+
46
+ | Mode | When to use | What it does |
47
+ |------|-------------|-------------|
48
+ | `"full"` (default) | `.thmx` files, requires Office | Applies complete theme (colors, fonts, backgrounds) via PowerPoint |
49
+ | `"extract"` | No Office available | Extracts colors/fonts only, generates via PptxGenJS |
50
+
51
+ **`.thmx` files:** Use `themeMode: "full"` — applies the complete theme including backgrounds and slide masters.
52
+
53
+ **`.pptx` files as theme source:** Only extracts basic colors/fonts. Does NOT reproduce custom slide masters, logos, or branded layouts. If the user needs exact custom layouts preserved, use the editing/duplicate workflow instead (see SKILL.md).
54
+
55
+ ---
56
+
57
+ ## Layout Selection by Keywords
58
+
59
+ **See the full layout keywords table in SKILL.md** ("Layout Selection by Keywords" section). Scan content for keywords → select matching layout. DO NOT default everything to `content`!
60
+
61
+ ---
62
+
63
+ ## Presentation Diversity (MANDATORY)
64
+
65
+ **Every presentation MUST use at least 3 different layout types:**
66
+
67
+ | Presentation Size | Minimum Layout Variety |
68
+ |-------------------|------------------------|
69
+ | 5-7 slides | 3+ different layouts |
70
+ | 8-10 slides | 4+ different layouts |
71
+ | 11+ slides | 5+ different layouts |
72
+
73
+ **❌ BAD:** title → content → content → content → content → closing
74
+ **✅ GOOD:** title → content → stats → imageRight → comparison → timeline → closing
75
+
76
+ **Scan your slide plan BEFORE building - if you see 3+ consecutive `content` layouts, restructure!**
77
+
78
+ ---
79
+
80
+ ## Alternating Image Layouts
81
+
82
+ When multiple image slides: alternate `imageLeft` ↔ `imageRight` for visual variety.
83
+
84
+ ```
85
+ Slide 3: imageRight
86
+ Slide 6: imageLeft ← alternated
87
+ Slide 9: imageRight ← alternated
88
+ ```
89
+
90
+ ---
91
+
92
+ ## 🖼️ Image Insertion (Post-Generation Edits Only)
93
+
94
+ **Only needed if adding images AFTER generation (e.g., replacing placeholder images).**
95
+
96
+ **⚠️ ALWAYS use `targetShapeName` - omitting causes overlapping!**
97
+
98
+ ```json
99
+ // 1. Analyze to get placeholder name
100
+ {"endpoint": "/ppt/analyze-slide-content", "body": {"filePath": "...", "slideNumbers": [3]}}
101
+
102
+ // 2. Insert INTO placeholder
103
+ {"endpoint": "/ppt/insert-image", "body": {
104
+ "filePath": "...", "slideNumber": 3,
105
+ "imagePath": "/path/to/image.png",
106
+ "targetShapeName": "Picture Placeholder 2"
107
+ }}
108
+ ```
109
+
110
+ **Rules:** Always analyze first → Use exact placeholder name → One image per placeholder
111
+
112
+ ---
113
+
114
+ ## ⚠️ Common Issues & Prevention
115
+
116
+ ### 1. Overlapping Text
117
+ **Cause:** Too much text in a placeholder
118
+ **Fix:** Max 5-7 bullet points per slide. Keep bullets to 1-2 lines each. Split content across multiple slides if needed.
119
+
120
+ ### 2. Images Overlapping or in Wrong Position
121
+ **Cause:** Inserting images WITHOUT `targetShapeName` parameter
122
+ **Fix:** ALWAYS use `targetShapeName` in `/ppt/insert-image`. ALWAYS run `/ppt/analyze-slide-content` FIRST.
123
+
124
+ ### 3. Repeating/Duplicate Text
125
+ **Cause:** Adding text without clearing existing content
126
+ **Fix:** ALWAYS use `clearExistingText: true` when replacing content.
127
+
128
+ ### 4. Wrong Shape Names
129
+ **Cause:** Guessing shape names instead of reading them
130
+ **Fix:** ALWAYS run `/ppt/analyze-slide-content` BEFORE adding text. Copy shape names EXACTLY (case-sensitive).
131
+
132
+ ---
133
+
134
+ ## Quality Checklist (After Building)
135
+
136
+ Run `/ppt/review-slides` and verify:
137
+ - [ ] No overlapping text warnings
138
+ - [ ] No empty placeholder warnings
139
+ - [ ] All images properly positioned
140
+ - [ ] Consistent font sizes
141
+ - [ ] No duplicate content