@uipath/delegate-sdk 1.203.1 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,531 @@
1
+ # Level 1: Common Workflow Examples
2
+
3
+ Step-by-step workflow patterns for typical PowerPoint tasks using the API endpoints.
4
+
5
+ ---
6
+
7
+ ## Workflow 1: Create Presentation from Scratch
8
+
9
+ **User Request:** "Create a quarterly report presentation with title, agenda, and content slides"
10
+
11
+ ### Step 1: Create New Presentation
12
+ ```json
13
+ endpoint: "/ppt/open-attach"
14
+ body: {
15
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
16
+ "createNew": true
17
+ }
18
+ ```
19
+ Response includes: `slides[]`, `totalSlides`
20
+
21
+ ### Step 2: Analyze First Slide (Title Slide)
22
+ ```json
23
+ endpoint: "/ppt/analyze-slide-content"
24
+ body: {
25
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
26
+ "slideNumbers": [1]
27
+ }
28
+ ```
29
+ Response includes: `shapeNames: ["Title 1", "Subtitle 2"]`
30
+
31
+ ### Step 3: Add Title Content
32
+ ```json
33
+ endpoint: "/ppt/add-text-to-slide"
34
+ body: {
35
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
36
+ "slideNumber": 1,
37
+ "targetShapeName": "Title 1",
38
+ "text": "Q4 2024 Business Review",
39
+ "clearExistingText": true
40
+ }
41
+ ```
42
+
43
+ ### Step 4: Add Subtitle
44
+ ```json
45
+ endpoint: "/ppt/add-text-to-slide"
46
+ body: {
47
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
48
+ "slideNumber": 1,
49
+ "targetShapeName": "Subtitle 2",
50
+ "text": "Presented by Finance Team\nJanuary 2025",
51
+ "clearExistingText": true
52
+ }
53
+ ```
54
+
55
+ ### Step 5: Insert Agenda Slide
56
+ ```json
57
+ endpoint: "/ppt/insert-slide"
58
+ body: {
59
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
60
+ "position": 2,
61
+ "slideLayout": "Title and Content"
62
+ }
63
+ ```
64
+ Response includes: `shapes[]` for the new slide
65
+
66
+ ### Step 6: Add Agenda Content
67
+ ```json
68
+ endpoint: "/ppt/add-text-to-slide"
69
+ body: {
70
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
71
+ "slideNumber": 2,
72
+ "targetShapeName": "Title 1",
73
+ "text": "Agenda",
74
+ "clearExistingText": true
75
+ }
76
+ ```
77
+
78
+ ```json
79
+ endpoint: "/ppt/add-text-to-slide"
80
+ body: {
81
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
82
+ "slideNumber": 2,
83
+ "targetShapeName": "Content Placeholder 2",
84
+ "text": "1. Financial Highlights\n2. Key Achievements\n3. Challenges & Lessons\n4. Q1 2025 Outlook",
85
+ "clearExistingText": true
86
+ }
87
+ ```
88
+
89
+ ### Step 7: Insert Content Slide with Chart
90
+ ```json
91
+ endpoint: "/ppt/insert-slide"
92
+ body: {
93
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
94
+ "position": 3,
95
+ "slideLayout": "Title Only"
96
+ }
97
+ ```
98
+
99
+ ```json
100
+ endpoint: "/ppt/add-text-to-slide"
101
+ body: {
102
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
103
+ "slideNumber": 3,
104
+ "targetShapeName": "Title 1",
105
+ "text": "Financial Highlights",
106
+ "clearExistingText": true
107
+ }
108
+ ```
109
+
110
+ ```json
111
+ endpoint: "/ppt/insert-chart"
112
+ body: {
113
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx",
114
+ "slideNumber": 3,
115
+ "chartType": "Column",
116
+ "chartTitle": "Quarterly Revenue",
117
+ "categories": ["Q1", "Q2", "Q3", "Q4"],
118
+ "series": [
119
+ { "name": "2023", "values": [2.1, 2.3, 2.5, 2.8] },
120
+ { "name": "2024", "values": [2.4, 2.7, 3.0, 3.4] }
121
+ ]
122
+ }
123
+ ```
124
+
125
+ ### Step 8: Run Health Check (AUTOMATIC)
126
+ **Always run health check yourself after creating/editing:**
127
+ ```json
128
+ endpoint: "/ppt/review-slides"
129
+ body: {
130
+ "filePath": "C:\\Users\\Documents\\Q4_Report.pptx"
131
+ }
132
+ ```
133
+ **If warnings found:** YOU apply fixes from `issue-fix-mapping.md` in the one corrective pass (if the user asked for a content review, run it first and fix both in that pass), re-run the health check once, and report what remains (SKILL.md Core Principle 4).
134
+
135
+ ### Step 9: Ask User About Full Review (OPTIONAL)
136
+ **After the health check, ask the user if they want a full content review, unless they already asked for one (then run it):**
137
+
138
+ Example: "Would you like me to do a full content review of the presentation before we're done?"
139
+
140
+ If user wants full review, delegate to `Agent` with `agent_type: "review"`; it will check content accuracy, spelling, and fact-check claims.
141
+
142
+ ---
143
+
144
+ ## Workflow 2: Edit Existing Presentation
145
+
146
+ **User Request:** "Update the sales figures in slide 3 and add speaker notes"
147
+
148
+ ### Step 1: Open Presentation
149
+ ```json
150
+ endpoint: "/ppt/open-attach"
151
+ body: {
152
+ "filePath": "C:\\Users\\Documents\\Sales_Deck.pptx"
153
+ }
154
+ ```
155
+
156
+ ### Step 2: Analyze Target Slide
157
+ ```json
158
+ endpoint: "/ppt/analyze-slide-content"
159
+ body: {
160
+ "filePath": "C:\\Users\\Documents\\Sales_Deck.pptx",
161
+ "slideNumbers": [3]
162
+ }
163
+ ```
164
+ Response: `shapeNames: ["Title 1", "Content Placeholder 2", "Chart 3"]`
165
+
166
+ ### Step 3: Update Content (ALWAYS use clearExistingText!)
167
+ ```json
168
+ endpoint: "/ppt/add-text-to-slide"
169
+ body: {
170
+ "filePath": "C:\\Users\\Documents\\Sales_Deck.pptx",
171
+ "slideNumber": 3,
172
+ "targetShapeName": "Content Placeholder 2",
173
+ "text": "- Total Revenue: $3.4M (+21% YoY)\n- New Customers: 145 (+35%)\n- Retention Rate: 94%",
174
+ "clearExistingText": true
175
+ }
176
+ ```
177
+
178
+ ### Step 4: Add Speaker Notes
179
+ ```json
180
+ endpoint: "/ppt/add-speaker-notes"
181
+ body: {
182
+ "filePath": "C:\\Users\\Documents\\Sales_Deck.pptx",
183
+ "slideNumber": 3,
184
+ "notes": "Key talking points:\n- Highlight the 21% YoY growth\n- Mention top 3 new enterprise clients\n- Address retention improvement initiatives"
185
+ }
186
+ ```
187
+
188
+ ### Step 5: Run Health Check (AUTOMATIC)
189
+ **Always run health check yourself after editing:**
190
+ ```json
191
+ endpoint: "/ppt/review-slides"
192
+ body: {
193
+ "filePath": "C:\\Users\\Documents\\Sales_Deck.pptx",
194
+ "slideNumbers": [3]
195
+ }
196
+ ```
197
+ **If warnings found:** Fix them yourself, then re-run health check.
198
+
199
+ ### Step 6: Ask User About Full Review (OPTIONAL)
200
+ **After the health check, ask if they want a full content review via `Agent` with `agent_type: "review"`, unless they already asked for one (then run it).**
201
+
202
+ ---
203
+
204
+ ## Workflow 3: Duplicate and Modify Slides (Template Pattern)
205
+
206
+ **User Request:** "Create 4 regional slides using slide 5 as template"
207
+
208
+ ### Step 1: Open and Analyze Template
209
+ ```json
210
+ endpoint: "/ppt/open-attach"
211
+ body: {
212
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx"
213
+ }
214
+ ```
215
+
216
+ ```json
217
+ endpoint: "/ppt/analyze-slide-content"
218
+ body: {
219
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
220
+ "slideNumbers": [5]
221
+ }
222
+ ```
223
+
224
+ ### Step 2: Duplicate Template Slide
225
+ ```json
226
+ endpoint: "/ppt/duplicate-slides"
227
+ body: {
228
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
229
+ "startSlideNumber": 5,
230
+ "count": 4
231
+ }
232
+ ```
233
+ Response includes: `newSlideNumbers: [6, 7, 8, 9]`, `newSlideShapes`
234
+
235
+ ### Step 3: Modify ONLY What Needs to Change
236
+ Use the `newSlideShapes` from duplicate response - no need to analyze!
237
+
238
+ **🚨 CRITICAL: All content is already copied from the template!**
239
+ - Subtitle → already there (DO NOT re-add)
240
+ - Body content → already there (DO NOT re-add)
241
+ - Only CHANGE the title (which differs per region)
242
+
243
+ **Slide 6 (North Region) - ONLY change title:**
244
+ ```json
245
+ endpoint: "/ppt/add-text-to-slide"
246
+ body: {
247
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
248
+ "slideNumber": 6,
249
+ "targetShapeName": "Title 1",
250
+ "text": "North Region Performance",
251
+ "clearExistingText": true
252
+ }
253
+ ```
254
+
255
+ **Slide 7 (South Region) - ONLY change title:**
256
+ ```json
257
+ endpoint: "/ppt/add-text-to-slide"
258
+ body: {
259
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
260
+ "slideNumber": 7,
261
+ "targetShapeName": "Title 1",
262
+ "text": "South Region Performance",
263
+ "clearExistingText": true
264
+ }
265
+ ```
266
+
267
+ *(Continue for slides 8 and 9 - ONLY changing titles, NOT re-adding subtitles or content)*
268
+
269
+ **❌ WRONG - Do NOT do this (causes doubled content):**
270
+ ```json
271
+ // DON'T add subtitle that's already there from duplication!
272
+ endpoint: "/ppt/add-text-to-slide"
273
+ body: {
274
+ "slideNumber": 7,
275
+ "targetShapeName": "Subtitle 2",
276
+ "text": "Q4 2024 Results" // Already exists from template!
277
+ }
278
+ ```
279
+
280
+ ### Step 4: Delete Original Template (Optional)
281
+ ```json
282
+ endpoint: "/ppt/delete-slide"
283
+ body: {
284
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
285
+ "slideNumber": 5
286
+ }
287
+ ```
288
+ Note: After deletion, slides 6-9 become 5-8.
289
+
290
+ ### Step 5: Run Health Check (AUTOMATIC)
291
+ **Always run health check yourself after duplicating:**
292
+ ```json
293
+ endpoint: "/ppt/review-slides"
294
+ body: {
295
+ "filePath": "C:\\Users\\Documents\\Regional_Report.pptx",
296
+ "slideNumbers": [5, 6, 7, 8]
297
+ }
298
+ ```
299
+ **If warnings found:** Fix them yourself, then re-run health check.
300
+
301
+ ### Step 6: Ask User About Full Review (OPTIONAL)
302
+ **After the health check, ask if they want a full content review via `Agent` with `agent_type: "review"`, unless they already asked for one (then run it).**
303
+
304
+ ---
305
+
306
+ ## Workflow 4: Insert Table with Data
307
+
308
+ **User Request:** "Add a comparison table to slide 4"
309
+
310
+ ### Step 1: Analyze Slide
311
+ ```json
312
+ endpoint: "/ppt/analyze-slide-content"
313
+ body: {
314
+ "filePath": "C:\\Users\\Documents\\Comparison.pptx",
315
+ "slideNumbers": [4]
316
+ }
317
+ ```
318
+
319
+ ### Step 2: Insert Table
320
+ ```json
321
+ endpoint: "/ppt/insert-table"
322
+ body: {
323
+ "filePath": "C:\\Users\\Documents\\Comparison.pptx",
324
+ "slideNumber": 4,
325
+ "table": [
326
+ ["Feature", "Basic Plan", "Pro Plan", "Enterprise"],
327
+ ["Users", "5", "25", "Unlimited"],
328
+ ["Storage", "10 GB", "100 GB", "1 TB"],
329
+ ["Support", "Email", "Priority", "24/7 Dedicated"],
330
+ ["Price/mo", "$9", "$29", "$99"]
331
+ ]
332
+ }
333
+ ```
334
+
335
+ ### Step 3: Run Health Check (AUTOMATIC)
336
+ **Always run health check yourself after inserting table:**
337
+ ```json
338
+ endpoint: "/ppt/review-slides"
339
+ body: {
340
+ "filePath": "C:\\Users\\Documents\\Comparison.pptx",
341
+ "slideNumbers": [4]
342
+ }
343
+ ```
344
+ **If warnings found:** Fix them yourself, then re-run health check.
345
+
346
+ ### Step 4: Ask User About Full Review (OPTIONAL)
347
+ **After the health check, ask if they want a full content review via `Agent` with `agent_type: "review"`, unless they already asked for one (then run it).**
348
+
349
+ ---
350
+
351
+ ## Workflow 5: Extract and Display Data
352
+
353
+ **User Request:** "What's in slide 3?"
354
+
355
+ ### Step 1: Extract Slide Data (NOT scripts!)
356
+ ```json
357
+ endpoint: "/ppt/extract-slide-data"
358
+ body: {
359
+ "filePath": "C:\\Users\\Documents\\Report.pptx",
360
+ "slideNumber": 3
361
+ }
362
+ ```
363
+ Response includes: `textContent[]`, `tables[]`, `charts[]`
364
+
365
+ ### Step 2: Display to User
366
+ Use the extracted data to summarize the slide content for the user.
367
+
368
+ **NEVER use scripts to extract data - use the API endpoint!**
369
+
370
+ ---
371
+
372
+ ## Workflow 6: Apply Theme and Format
373
+
374
+ **User Request:** "Apply corporate theme and fix formatting" (on existing presentation)
375
+
376
+ **⚠️ Note:** This workflow is for EDITING existing presentations. For CREATING new presentations with a custom theme, use `themePath` in the generator JSON options instead!
377
+
378
+ ### Step 1: Apply Theme (Editing Only)
379
+ ```json
380
+ endpoint: "/ppt/apply-theme"
381
+ body: {
382
+ "filePath": "C:\\Users\\Documents\\Presentation.pptx",
383
+ "themeFilePath": "C:\\Themes\\Corporate.thmx"
384
+ }
385
+ ```
386
+
387
+ Or use built-in theme:
388
+ ```json
389
+ endpoint: "/ppt/apply-theme"
390
+ body: {
391
+ "filePath": "C:\\Users\\Documents\\Presentation.pptx",
392
+ "themeName": "Office Theme"
393
+ }
394
+ ```
395
+
396
+ ### Step 2: Format Specific Content
397
+ ```json
398
+ endpoint: "/ppt/format-slide-content"
399
+ body: {
400
+ "filePath": "C:\\Users\\Documents\\Presentation.pptx",
401
+ "slideNumbers": [1],
402
+ "shapeName": "Title 1",
403
+ "fontSize": 44,
404
+ "bold": true,
405
+ "fontColor": "#003366"
406
+ }
407
+ ```
408
+
409
+ ### Step 3: Run Health Check (AUTOMATIC)
410
+ **Always run health check yourself after applying theme:**
411
+ ```json
412
+ endpoint: "/ppt/review-slides"
413
+ body: {
414
+ "filePath": "C:\\Users\\Documents\\Presentation.pptx"
415
+ }
416
+ ```
417
+ **If warnings found:** Fix them yourself, then re-run health check.
418
+
419
+ ### Step 4: Ask User About Full Review (OPTIONAL)
420
+ **After the health check, ask if they want a full content review via `Agent` with `agent_type: "review"`, unless they already asked for one (then run it).**
421
+
422
+ If the user wants a review, call `Agent` with `agent_type: "review"` to verify the presentation and report issues.
423
+
424
+ **Example of what the Agent review does internally (read-only verification):**
425
+ ```json
426
+ endpoint: "/ppt/review-slides"
427
+ body: {
428
+ "filePath": "C:\\Users\\Documents\\Presentation.pptx"
429
+ }
430
+ ```
431
+
432
+ ---
433
+
434
+ ## Common Patterns
435
+
436
+ ### Pattern: Always Analyze Before Edit
437
+ ```json
438
+ // Step 1: Get shape names
439
+ endpoint: "/ppt/analyze-slide-content"
440
+ body: { "filePath": "...", "slideNumbers": [2] }
441
+
442
+ // Step 2: Use EXACT shape names from response
443
+ endpoint: "/ppt/add-text-to-slide"
444
+ body: {
445
+ "targetShapeName": "Content Placeholder 2", // From analyze response
446
+ "clearExistingText": true // ALWAYS include this!
447
+ }
448
+ ```
449
+
450
+ ### Pattern: Duplicate Returns Shapes (Skip Analyze)
451
+ ```json
452
+ // duplicate-slides returns newSlideShapes - use directly!
453
+ endpoint: "/ppt/duplicate-slides"
454
+ body: { "filePath": "...", "startSlideNumber": 3, "count": 2 }
455
+ // Response: { "newSlideNumbers": [4, 5], "newSlideShapes": { "4": [...], "5": [...] } }
456
+
457
+ // Use shape names from response - no analyze needed!
458
+ endpoint: "/ppt/add-text-to-slide"
459
+ body: { "slideNumber": 4, "targetShapeName": "Title 1", ... }
460
+ ```
461
+
462
+ ### Pattern: Health Check (AUTOMATIC) + Full Review (ASK USER)
463
+ ```
464
+ 1. ALWAYS run health check yourself after any operation:
465
+ endpoint: "/ppt/review-slides"
466
+ body: { "filePath": "..." }
467
+ 2. IF warnings found:
468
+ a. For each issue: YOU apply the fix from issue-fix-mapping.md (the one corrective pass; if the user asked for a content review, run it first and fix both together)
469
+ b. Re-run the health check once
470
+ c. Report the warnings that remain; they do not block handoff (SKILL.md Core Principle 4)
471
+ 3. After the health check, ASK user if they want full content review (already asked → run it now)
472
+ 4. If yes → call `Agent` with `agent_type: "review"` for content review, spelling, and fact-checking
473
+ 5. If no → inform user the presentation is ready
474
+ ```
475
+
476
+ **Health check = run yourself (catches technical issues)**
477
+ **Full review = call `Agent` with `agent_type: "review"` (checks content, spelling, facts)**
478
+
479
+ ### Pattern: Extract Data via API (Never Scripts)
480
+ ```json
481
+ // CORRECT: Use API endpoint
482
+ endpoint: "/ppt/extract-slide-data"
483
+ body: { "filePath": "...", "slideNumber": 3 }
484
+
485
+ // WRONG: Never use scripts for extraction
486
+ // endpoint: "/ppt/execute-script" <-- DON'T DO THIS
487
+ ```
488
+
489
+ ---
490
+
491
+ ## Anti-Patterns (NEVER Do This)
492
+
493
+ ### Never Edit Without Analyzing First
494
+ ```json
495
+ // WRONG: Guessing shape names
496
+ endpoint: "/ppt/add-text-to-slide"
497
+ body: { "targetShapeName": "Title" } // Might be "Title 1" - will fail!
498
+
499
+ // CORRECT: Analyze first, use exact name
500
+ endpoint: "/ppt/analyze-slide-content"
501
+ // Response: "Title 1"
502
+ endpoint: "/ppt/add-text-to-slide"
503
+ body: { "targetShapeName": "Title 1" }
504
+ ```
505
+
506
+ ### Never Forget clearExistingText
507
+ ```json
508
+ // WRONG: Content doubles up!
509
+ endpoint: "/ppt/add-text-to-slide"
510
+ body: { "text": "New content" } // Missing clearExistingText!
511
+
512
+ // CORRECT: Always include when replacing
513
+ endpoint: "/ppt/add-text-to-slide"
514
+ body: { "text": "New content", "clearExistingText": true }
515
+ ```
516
+
517
+ ### Health Check vs Full Review
518
+ ```
519
+ // CORRECT: Always run health check yourself (automatic)
520
+ endpoint: "/ppt/review-slides"
521
+ body: { "filePath": "..." }
522
+ // Fix issues found in one pass, re-run once
523
+
524
+ // CORRECT: Ask user before calling Agent with agent_type: "review"
525
+ // "Would you like me to do a full content review?"
526
+ // If yes → call Agent with agent_type: "review" for content/spelling/fact-check
527
+ // If no → inform user the presentation is ready
528
+
529
+ // WRONG: Skipping health check entirely
530
+ // WRONG: Calling Agent with agent_type: "review" without asking, unless the user already asked for a review
531
+ ```