@uipath/delegate-sdk 1.203.0 → 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,271 @@
1
+ # PowerPoint Architect - macOS Reference
2
+
3
+ macOS PowerPoint automation uses its `/ppt/*` endpoint set via `ExecuteSkillApi`. AppleScript handlers implement these endpoints.
4
+
5
+ ## Execution Priority (macOS)
6
+
7
+ | Priority | Approach | Tool | Best For |
8
+ |----------|----------|------|----------|
9
+ | **1st** | Generator | `/ppt-gen/generate` via ExecuteSkillApi | Creating new presentations |
10
+ | **2nd** | ExecuteSkillApi | `/ppt/*` endpoints | All operations in the macOS endpoint set |
11
+ | **3rd** | UI automation | AppAct | UI fallback when API fails 2+ times |
12
+
13
+ **Use ExecuteSkillApi with the macOS `/ppt/*` endpoints for ALL operations.** This includes `/ppt/select-slide` for navigating between slides.
14
+
15
+ ---
16
+
17
+ ## Creation (New Presentation)
18
+ | Task | Endpoint | Key Parameters |
19
+ |------|----------|----------------|
20
+ | Generate new presentation | `/ppt-gen/generate` | options (title, theme/themePath, outputPath), slides |
21
+ | List generator themes | `/ppt-gen/list-themes` | - |
22
+ | Render Mermaid diagram to PNG | `/diagram/render-mermaid` | code, outputPath |
23
+
24
+ **Note:** `/ppt-gen/*` creates presentations from scratch (no PowerPoint needed — pure TS/pptxgenjs). `/ppt/*` 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.
25
+
26
+ ---
27
+
28
+ ## Endpoint Reference (macOS)
29
+
30
+ Call every operation through ExecuteSkillApi `/ppt/*` endpoints — same call shape as Windows. The AppleScript files under `macos/scripts/` are the internal implementation the executor runs on your behalf; they are not a separate API. Do NOT invoke them directly with raw `osascript` — that bypasses argument validation, presentation activation, and the tool execution policy layer.
31
+
32
+ ### Slide Operations
33
+ | Endpoint | Key Parameters | Script (implementation) |
34
+ |----------|-----------------|--------------------------|
35
+ | `/ppt/insert-slide` | position, slideLayout | `add-slide.applescript` |
36
+ | `/ppt/delete-slide`, `/ppt/delete-slides` | slideNumber or slideNumbers (array), or a range string (`"3-7"`, `"2,4-6"`) | `delete-slides.applescript` |
37
+ | `/ppt/duplicate-slide`, `/ppt/duplicate-slides` | startSlideNumber, or slideNumbers/sourceSlides (array, any order — sorted and de-duplicated for you), plus targetPosition. Without targetPosition each copy lands directly after its source; with it, all copies form one contiguous block starting at targetPosition in ascending source order. Returns `newSlideNumbers[]` + `totalSlides` | `copy-slides.applescript` |
38
+ | `/ppt/copy-slides` | Same parameters and placement rules as duplicate-slides. Returns `message` only — call `/ppt/get-presentation-info` if you need the new positions | `copy-slides.applescript` |
39
+ | `/ppt/reorder-slide`, `/ppt/reorder-slides` | slideNumber, newPosition | `reorder-slides.applescript` |
40
+ | `/ppt/select-slide`, `/ppt/navigate-to-slide` | slideNumber | `navigate-to-slide.applescript` |
41
+ | `/ppt/apply-slide-layout` | slideNumber, layoutName | `apply-slide-layout.applescript` |
42
+
43
+ ### Content Operations
44
+ | Endpoint | Key Parameters | Script (implementation) |
45
+ |----------|-----------------|--------------------------|
46
+ | `/ppt/add-text-to-slide` | slideNumber, targetShapeName, text | `add-text.applescript` |
47
+ | `/ppt/insert-text-box`, `/ppt/add-textbox`, `/ppt/add-text-box` | slideNumber, text, left/top/width/height, fontColor | `insert-text-box.applescript` |
48
+ | `/ppt/replace-text` | oldText, newText, matchCase, replaceAll | `replace-text.applescript` |
49
+ | `/ppt/insert-image`, `/ppt/replace-image` | slideNumber, imagePath, left/top/width/height (insert); shapeName, newImagePath (replace) | `manage-image.applescript` |
50
+ | `/ppt/insert-shape` | slideNumber, shapeType, left/top/width/height | `insert-shape.applescript` |
51
+ | `/ppt/insert-table` | slideNumber, rows, columns, table (2D array; `data`/`tableData` also accepted; rows/columns inferred from `table` when omitted) | `insert-table.applescript` |
52
+ | `/ppt/add-speaker-notes` | slideNumber, notes | `add-speaker-notes.applescript` |
53
+ | `/ppt/insert-chart` | slideNumber, chartType, categories + series (or data string) | `create-chart-with-data.applescript` |
54
+ | `/ppt/add-html-to-slide` | slideNumber, targetShapeName, html, fontFamily, fontSize | `add-html-to-slide.applescript` — **preferred** for formatted text (bold, italic, lists, headings) |
55
+ | `/ppt/extract-slide-data` | slideNumber or slideNumbers (array); omit both for all slides | `extract-slide-data.applescript` |
56
+
57
+ ### Layout & Formatting
58
+ | Endpoint | Key Parameters | Script (implementation) |
59
+ |----------|-----------------|--------------------------|
60
+ | `/ppt/apply-theme` | themeName or themeFilePath (e.g. Gallery, Ion), or randomTheme: true | `apply-theme.applescript` |
61
+ | `/ppt/format-shape` | slideNumber, shapeName, left/top/width/height/deltaX/deltaY/rotation/visible | `format-shape.applescript` |
62
+ | `/ppt/format-slide-content` | slideNumber or slideNumbers, shapeName, fontSize/fontName/bold/italic/underline/color/align, textMatch. `textMatch` scopes the font changes to the **first** occurrence of that substring (case-insensitive) instead of the whole shape — Windows formats every occurrence. It only narrows the scope, so at least one real formatting option must accompany it. `align` is paragraph-level and always applies to the whole shape | `format-slide-content.applescript` |
63
+ | `/ppt/autofit-placeholders`, `/ppt/optimize-slide`, `/ppt/optimize-slides` | filePath, slideNumber (or all: true). `deleteEmpty` is **not supported on macOS**: the autofit still runs, a `warning` reports that no shapes were removed. Hide an empty placeholder with `/ppt/format-shape` `visible: false` | `autofit-placeholders.applescript` |
64
+ | `/ppt/set-transition` | slideNumber, transitionType, duration | `set-transition.applescript` |
65
+ | `/ppt/set-animation` | slideNumber, shapeName, animationType, effect, duration, trigger | `set-animation.applescript` |
66
+
67
+ ### Info & Export
68
+ | Endpoint | Key Parameters | Script (implementation) |
69
+ |----------|-----------------|--------------------------|
70
+ | `/ppt/get-presentation-info` | filePath | `get-presentation-info.applescript` |
71
+ | `/ppt/analyze-slide-content` | filePath, slideNumbers (array); omit slideNumbers for a whole-presentation summary | `get-presentation-info.applescript` / `get-slide-info.applescript` |
72
+ | `/ppt/get-slide-info` | filePath, slideNumber (optional) | `get-slide-info.applescript` |
73
+ | `/ppt/get-layout-elements` | filePath, layoutName (optional) | `get-layout-elements.applescript` |
74
+ | `/ppt/get-slide-count` | filePath | `get-slide-count.applescript` |
75
+ | `/ppt/get-current-slide-number` | filePath | `get-current-slide-number.applescript` |
76
+ | `/ppt/get-layouts` | filePath | `get-layouts.applescript` |
77
+ | `/ppt/get-file-path`, `/ppt/get-presentation-path` | filePath | `get-file-path.applescript` |
78
+ | `/ppt/get-opened-files` | - | `get-opened-files.applescript` |
79
+ | `/ppt/get-recent-files` | maxCount (default 10) | `get-recent-files.applescript` |
80
+ | `/ppt/save-as-pdf`, `/ppt/export-presentation` | filePath, pdfFilePath or exportPath, format (default `pdf`) | `export-presentation.applescript` |
81
+ | `/ppt/review-slides`, `/ppt/validate-live` | filePath, slideNumbers (optional) — `validate-live` is an alias of `review-slides` | `health-check.applescript` |
82
+
83
+ ### Presentation Control
84
+ | Endpoint | Key Parameters | Script (implementation) |
85
+ |----------|-----------------|--------------------------|
86
+ | `/ppt/open-attach` | filePath, createNew, themePath/theme/themeName | `open-presentation.applescript` / `create-with-theme.applescript` |
87
+ | `/ppt/close`, `/ppt/close-presentation` | filePath (saves first, then closes) | `close-presentation.applescript` |
88
+ | `/ppt/save-presentation` | `filePath` identifies the deck (required). Omit `saveAsPath` to save in place; pass `saveAsPath` (absolute POSIX path — relative paths are rejected) to Save As to that path. **After a Save As the newly-saved file becomes the open document, so every later call must use the NEW path** — reusing the old one fails with `DELEGATE_OFFICE_TARGET_NOT_OPEN` | `save-presentation.applescript` |
89
+ | `/ppt/maximize-window` | - | `maximize-window.applescript` |
90
+
91
+ Mutating endpoints (insert/add/replace/format/delete/duplicate/copy/reorder/transition/animation/theme/layout/autofit) save the presentation automatically on success. A save failure after a successful edit is reported as a `warning` field, not an error.
92
+
93
+ **A presentation the user has never saved cannot be used at all.** Every `/ppt/*` call except `get-opened-files`, `get-recent-files`, and `maximize-window` needs a real `filePath` and is refused with `DELEGATE_OFFICE_TARGET_NOT_OPEN` when no open document matches it, and a pathless deck can never match. You cannot save it on the user's behalf either — a destination-less save lands in PowerPoint's sandbox container where they will not find it. Ask the user to save it (File > Save As), then `/ppt/open-attach` that path.
94
+
95
+ ---
96
+
97
+ ## SharePoint / OneDrive Files
98
+
99
+ To open a file from SharePoint or OneDrive — **never download via HTTP** (auth will fail) or click through browser UI.
100
+
101
+ **⚠️ Do NOT use the shell `open` command** with `ms-powerpoint:ofe|u|` — it corrupts the URL (strips a `/` from `https://`), causing "PowerPoint can't read" errors. Also do NOT use `tell application "Microsoft PowerPoint" to open "<url>"` — PowerPoint cannot authenticate to SharePoint without the protocol handler.
102
+
103
+ **Use AppleScript `open location` instead:**
104
+ ```bash
105
+ osascript -e 'open location "ms-powerpoint:ofe|u|<direct_file_url>"'
106
+ ```
107
+
108
+ **⚠️ URL encoding and spaces:** macOS `open location` can sometimes double-encode `%20` → `%2520`, causing "PowerPoint can't open this file" errors. If the URL contains `%20` and opening fails, retry with `%20` decoded to literal spaces:
109
+ ```bash
110
+ # Try 1: URL as-is
111
+ osascript -e 'open location "ms-powerpoint:ofe|u|https://company.sharepoint.com/sites/team/Shared%20Documents/My%20File.pptx"'
112
+
113
+ # If "can't open" error → Try 2: decode %20 to spaces
114
+ osascript -e 'open location "ms-powerpoint:ofe|u|https://company.sharepoint.com/sites/team/Shared Documents/My File.pptx"'
115
+ ```
116
+
117
+ ### URL Format — CRITICAL
118
+
119
+ The URL **must** be the **direct document URL** ending in `.pptx`, for example:
120
+ ```
121
+ ✅ https://company-my.sharepoint.com/personal/user_name/Documents/MyFile.pptx
122
+ ✅ https://company.sharepoint.com/sites/team/Shared Documents/Deck.pptx
123
+ ```
124
+
125
+ **NEVER** use browser page URLs — PowerPoint will fail with "PowerPoint can't open this type of file":
126
+ ```
127
+ ❌ https://company.sharepoint.com/:p:/r/personal/user_name/_layouts/15/Doc.aspx?sourcedoc=%7B...%7D&action=edit
128
+ ❌ https://company.sharepoint.com/:p:/r/personal/user_name/Documents/File.pptx (has :p:/r/ prefix)
129
+ ```
130
+
131
+ **How to convert a browser URL to a direct URL:**
132
+
133
+ 1. **Strip the routing prefix** `/:p:/r/` or `/:p:/g/` — these are SharePoint sharing/routing prefixes
134
+ 2. **Strip query parameters** (`?sourcedoc=...&action=edit`)
135
+ 3. **Strip `_layouts/15/Doc.aspx`** paths entirely — reconstruct from the document library path
136
+ 4. **Fix the domain** for personal OneDrive files: `company.sharepoint.com` → `company-my.sharepoint.com`
137
+ - Personal files (path contains `/personal/`) use the `-my` subdomain
138
+ - Team/site files (path contains `/sites/`) use the base domain
139
+
140
+ **Conversion examples:**
141
+ ```
142
+ Browser: https://uipath.sharepoint.com/:p:/r/personal/john_doe_uipath_com/Documents/Deck.pptx
143
+ Direct: https://uipath-my.sharepoint.com/personal/john_doe_uipath_com/Documents/Deck.pptx
144
+ ^^^^^^^^^ add -my ^^^^^^^^^ strip :p:/r/
145
+
146
+ Browser: https://company.sharepoint.com/:p:/r/sites/team/_layouts/15/Doc.aspx?sourcedoc=%7B...%7D
147
+ Direct: Ask the user for the filename — cannot be reconstructed from _layouts URL
148
+
149
+ Browser: https://company.sharepoint.com/:p:/r/sites/team/Shared%20Documents/Report.pptx?d=w...
150
+ Direct: https://company.sharepoint.com/sites/team/Shared%20Documents/Report.pptx
151
+ (no -my for /sites/) ^^^^^^^^^ strip :p:/r/ ^^^^^^^^^ strip ?d=...
152
+ ```
153
+
154
+ Then call `/ppt/get-opened-files` to confirm it loaded and get the file path.
155
+
156
+ ### Workflow
157
+
158
+ 1. Open the SharePoint file via AppleScript `open location`:
159
+ ```bash
160
+ osascript -e 'open location "ms-powerpoint:ofe|u|<url>"'
161
+ ```
162
+ 2. Wait a few seconds for PowerPoint to load the file
163
+ 3. Call `/ppt/get-opened-files` — the returned path may be a local temp path (macOS downloads SharePoint files to a local cache, unlike Windows which keeps the URL)
164
+ 4. Use the returned `path` as `filePath` in all subsequent `/ppt/*` endpoints
165
+
166
+ ### Copy slides from a SharePoint source
167
+
168
+ Unlike Windows, macOS does **not** support cross-file `/ppt/copy-slides` with a `sourceFilePath`. Instead:
169
+
170
+ 1. Open the SharePoint source via `open location` (as above)
171
+ 2. Use `/ppt/get-opened-files` to get the local cached path
172
+ 3. Use the **Generator** with `themePath` pointing to the cached source path to create a new presentation with the same theme
173
+ 4. Or call `/ppt/copy-slides` (no `sourceFilePath`) within the open source presentation to duplicate slides there, then edit content in place
174
+
175
+ ### If the file is already open
176
+
177
+ If the user already opened the file in desktop PowerPoint (e.g., from browser "Open in Desktop App"), just call `/ppt/get-opened-files` to get the file path and proceed.
178
+
179
+ ---
180
+
181
+ ## Layout Names
182
+
183
+ For `/ppt/insert-slide` (`slideLayout`) and `/ppt/apply-slide-layout` (`layoutName`):
184
+
185
+ | Layout Name | Description |
186
+ |-------------|-------------|
187
+ | `title` | Title slide (centered) |
188
+ | `content` | Title + content placeholder |
189
+ | `two-column` | Title + two columns |
190
+ | `title-only` | Title only |
191
+ | `blank` | Empty slide |
192
+ | `chart` | Chart layout |
193
+ | `table` | Table layout |
194
+ | `section` | Section header |
195
+ | `comparison` | Two-column comparison |
196
+ | `picture-caption` | Picture with caption |
197
+
198
+ ---
199
+
200
+ ## Common Workflows
201
+
202
+ ### Create Presentation with Custom Theme
203
+ 1. `/ppt-gen/generate` with `options.themePath` — creates the COMPLETE presentation (all slides) in one call.
204
+ 2. `/ppt/open-attach` with `filePath` — open the created file (skip if the generator already opened it).
205
+ 3. Edit further with `/ppt/*` endpoints as needed.
206
+
207
+ ### Edit Existing Presentation
208
+ 1. `/ppt/get-presentation-info` (or `/ppt/analyze-slide-content`) — get presentation info
209
+ 2. `/ppt/select-slide` with `slideNumber: 3` — navigate to target slide
210
+ 3. `/ppt/get-slide-info` with `slideNumber: 3` (or `/ppt/analyze-slide-content` with `slideNumbers: [3]`) — get shapes/placeholders
211
+ 4. `/ppt/insert-text-box` with `slideNumber: 3, text: "New content here"` — add content
212
+ 5. `/ppt/review-slides` — verify
213
+
214
+ ### Insert Formatted HTML Content
215
+ - `/ppt/add-html-to-slide` with `slideNumber: 1, targetShapeName: "Content Placeholder 2", html: "<ul><li><b>Bold item</b></li><li><i>Italic item</i></li></ul>"`
216
+ - With a specific font: `/ppt/add-html-to-slide` with `slideNumber: 2, targetShapeName: "Content Placeholder 2", html: "<p>Formatted text</p>", fontFamily: "Calibri"`
217
+
218
+ ### Export to PDF
219
+ `/ppt/save-as-pdf` with `pdfFilePath: "/path/to/output.pdf", format: "pdf"`
220
+
221
+ ---
222
+
223
+ ## Emoji / Unicode Limitations (macOS)
224
+
225
+ **NEVER use emoji characters (✅, ⚠️, ❌, etc.) in table cell data on macOS.** They render as "A" or "Aa" due to AppleScript/PowerPoint encoding issues.
226
+
227
+ Use text alternatives: `YES`/`NO`/`PARTIAL`, or `[+]`/`[-]`/`[~]`.
228
+
229
+ This does NOT affect regular text shapes (titles, content placeholders) — only table cells.
230
+
231
+ ---
232
+
233
+ ## Limitations vs Windows
234
+
235
+ | Feature | Windows | macOS |
236
+ |---------|---------|-------|
237
+ | Create presentations | ✅ Generator | ✅ Generator |
238
+ | Add/edit slides | ✅ API | ✅ AppleScript |
239
+ | Insert images | ✅ API | ✅ AppleScript |
240
+ | Charts/tables | ✅ API | ✅ AppleScript |
241
+ | Health check | ✅ `/ppt/review-slides` | ✅ `health-check.applescript` |
242
+ | Emoji in tables | ✅ Supported | ❌ Use text alternatives |
243
+ | HTML content insertion | ❌ Use add-text + format | ✅ `add-html-to-slide.applescript` |
244
+ | SharePoint open | ✅ PowerShell protocol | ✅ `open location` + `ms-powerpoint:` protocol |
245
+ | SharePoint cross-file copy | ✅ `/ppt/copy-slides` with URL | ❌ Open source first, use local cached path |
246
+ | Speed | Fast (API) | Medium (AppleScript) |
247
+
248
+ ---
249
+
250
+ ## Fallback to AppAct
251
+
252
+ If AppleScript fails for complex operations, use AppAct:
253
+ 1. Take screenshot to see UI state
254
+ 2. Use AppFind to locate elements
255
+ 3. Use AppAct to click/text_type
256
+ 4. Screenshot to verify
257
+
258
+ ---
259
+
260
+ ## Theme Detection
261
+
262
+ `get-presentation-info.applescript` reports the theme/design name and flags default themes. When `themeWarning` is present in the response, use the duplicate-slide + replace content pattern instead of insert-slide. See the "Theme Detection & Slide Insertion Strategy" section in the common `SKILL.md` for full details.
263
+
264
+ ---
265
+
266
+ ## Documentation
267
+
268
+ | File | Content | When to Load |
269
+ |------|---------|--------------|
270
+ | Common `SKILL.md` | Generator usage, styling, theme detection | Creating presentations |
271
+ | `custom_themes.md` | Custom theme workflow | Using .thmx files |