@uipath/delegate-sdk 1.203.1 → 1.203.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +729 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +444 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +224 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,424 @@
1
+ # Editing Existing Presentations
2
+
3
+ This file contains the complete editing workflow for PowerPoint presentations using ExecuteSkillApi.
4
+ **Loaded on demand from SKILL.md when editing an existing presentation.**
5
+
6
+ ---
7
+
8
+ ## Part 2: Editing Existing Presentations (ExecuteSkillApi)
9
+
10
+ Use **ExecuteSkillApi** with `/ppt/*` endpoints when editing existing presentations. Requires PowerPoint to be installed.
11
+
12
+ ### Execution Strategy
13
+
14
+ | Priority | Approach | Speed | Best For |
15
+ |----------|----------|-------|----------|
16
+ | **1st** | ExecuteSkillApi | Fastest | All presentation edits, text, images, charts |
17
+ | **2nd** | C# Script (Windows only — `/ppt/execute-script` doesn't exist on macOS) | Fast | Complex logic, custom automation |
18
+ | **3rd** | UIA (AppAct) | Slowest | Ribbon clicks, dialogs, animations |
19
+
20
+ If the user forbids arbitrary Office scripts, never call `/ppt/execute-script`. Use structured `/ppt/*` endpoints or report the limitation.
21
+
22
+ ### Fallback Strategy (MANDATORY)
23
+
24
+ **Windows: if ExecuteSkillApi or C# Script fails 2 consecutive times for the same operation, fall back to UIA (AppAct). macOS: if ExecuteSkillApi fails 2 consecutive times, fall back to UIA (AppAct) — there is no C# Script step.**
25
+
26
+ ```
27
+ Attempt 1: ExecuteSkillApi → fails
28
+ Attempt 2: ExecuteSkillApi → fails
29
+ Attempt 3: Switch to UIA (AppAct)
30
+ ```
31
+
32
+ **When to use UIA fallback:**
33
+ - COM automation fails repeatedly (locked UI, modal dialogs, etc.)
34
+ - Shape/placeholder not found despite correct name
35
+ - PowerPoint not responding to API calls
36
+ - Clipboard operations failing
37
+
38
+ **UIA can handle:**
39
+ - Clicking ribbon buttons and menus
40
+ - Navigating dialogs and prompts
41
+ - Direct keyboard input (Ctrl+C, Ctrl+V, etc.)
42
+ - Visual element interaction when COM fails
43
+
44
+ **Important:**
45
+ - UIA is slower but more reliable for edge cases. Don't skip directly to UIA - always try the faster approaches first.
46
+ - **Fallback is per-operation, not permanent.** After using UIA for one operation, try ExecuteSkillApi/Script again for the NEXT different operation. Only fall back to UIA again if that new operation also fails 2 times.
47
+
48
+ ---
49
+
50
+ ## Discovery-First Workflow (CRITICAL)
51
+
52
+ Before editing, ALWAYS discover the presentation structure:
53
+
54
+ ```
55
+ 1. Open/Attach -> Get file reference and slide list
56
+ 2. Analyze -> Get shape names and layout for target slide(s)
57
+ 3. Plan -> Determine what changes to make
58
+ 4. Execute -> Perform operations using exact shape names
59
+ 5. Verify -> /ppt/review-slides, then offer a content review (see Health Check & Review below)
60
+ ```
61
+
62
+ **Why Discovery Matters:**
63
+ - Shape names vary between presentations and templates
64
+ - Using wrong shape name = operation fails silently
65
+ - Prevents overwriting unintended content
66
+ - Health check catches layout issues, overlaps, and formatting problems
67
+
68
+ ---
69
+
70
+ ## Critical Rules
71
+
72
+ | Rule | Description |
73
+ |------|-------------|
74
+ | **Open first** | Always call `/ppt/open-attach` before any operation |
75
+ | **Analyze before edit** | Call `/ppt/analyze-slide-content` to get shape names before editing a slide for the first time |
76
+ | **Use exact shape names** | Copy shape names exactly from analyze response |
77
+ | **Extract via API** | Use `/ppt/extract-slide-data` for tables/text/charts - NEVER scripts |
78
+ | **clearExistingText: true** | Windows: ALWAYS use `clearExistingText: true` when replacing content to prevent doubling. macOS: `add-text-to-slide` always replaces; the flag is ignored. |
79
+ | **Health check + fix** | Run `/ppt/review-slides` and fix what it reports in one pass before declaring success (SKILL.md Core Principle 4) |
80
+ | **Auto-save enabled** | Changes save automatically, no explicit save needed |
81
+ | **Slide numbers are 1-based** | First slide = 1, not 0 |
82
+ | **No emoji in table data (macOS)** | On macOS, emoji characters (✅, ⚠️, ❌, etc.) in table cells render as "A" or "Aa" due to encoding issues. Use text alternatives instead: YES/NO/PARTIAL, or symbols like [+], [-], [~] |
83
+
84
+ ## Emoji / Unicode in Tables (macOS)
85
+
86
+ **On macOS, NEVER use emoji characters in table cell data.** Emoji like ✅ ⚠️ ❌ get corrupted during insertion and render as "A" or "Aa" — this is a known AppleScript/PowerPoint encoding limitation.
87
+
88
+ **Use text alternatives instead:**
89
+ | Instead of | Use |
90
+ |------------|-----|
91
+ | ✅ | `YES` or `[+]` or `SUPPORTED` |
92
+ | ❌ | `NO` or `[-]` or `NOT SUPPORTED` |
93
+ | ⚠️ | `PARTIAL` or `[~]` or `LIMITED` |
94
+
95
+ This applies to `/ppt/insert-table` data on macOS. Text in regular shapes (titles, content placeholders) is not affected.
96
+
97
+ ---
98
+
99
+ ## Standard Slide Layouts
100
+
101
+ **Use these layout names with `/ppt/insert-slide`:**
102
+
103
+ | Layout Name | Use For | Placeholders |
104
+ |-------------|---------|--------------|
105
+ | `Title Slide` | Opening/closing slides | Title 1, Subtitle 2 |
106
+ | `Title and Content` | Standard content slides | Title 1, Content Placeholder 2 |
107
+ | `Two Content` | Side-by-side content | Title 1, Content Placeholder 2, Content Placeholder 3 |
108
+ | `Comparison` | vs/comparison content | Title 1, Text Placeholder 2, Text Placeholder 3 |
109
+ | `Title Only` | Slides with charts/images | Title 1 |
110
+ | `Blank` | Full image or custom layout | (none) |
111
+ | `Section Header` | Section dividers | Title 1, Text Placeholder 2 |
112
+ | `Content with Caption` | Image + description | Title 1, Content Placeholder 2, Text Placeholder 3 |
113
+ | `Picture with Caption` | Single image + caption | Title 1, Picture Placeholder 2, Text Placeholder 3 |
114
+
115
+ **The API has smart fallback:** If layout doesn't exist in theme, it will try fuzzy matching then standard fallbacks.
116
+
117
+ **For custom themes:** Request the layout type you need - the API handles finding the best match.
118
+
119
+ ---
120
+
121
+ ## Content Replacement (CRITICAL - Prevent Doubling)
122
+
123
+ **Windows:** ALWAYS use `clearExistingText: true` when replacing content to prevent doubling.
124
+
125
+ **macOS:** `add-text-to-slide` always replaces shape content — it never appends, regardless of `clearExistingText`. Doubling can't happen, but intentional appending also isn't possible; use a separate shape or `/ppt/add-html-to-slide` to build combined content instead.
126
+
127
+ The rest of this section (examples, when to use `clearExistingText`) describes Windows behavior.
128
+
129
+ When you add text to a shape that already has content on Windows, the new text is **APPENDED** by default. This causes content to double.
130
+
131
+ **❌ WRONG - causes doubling:**
132
+ ```json
133
+ { "endpoint": "/ppt/add-text-to-slide", "body": {
134
+ "filePath": "C:/presentation.pptx",
135
+ "slideNumber": 3,
136
+ "targetShapeName": "Content Placeholder 2",
137
+ "text": "New content"
138
+ // Missing clearExistingText!
139
+ }}
140
+ ```
141
+
142
+ **✅ CORRECT - replaces content:**
143
+ ```json
144
+ { "endpoint": "/ppt/add-text-to-slide", "body": {
145
+ "filePath": "C:/presentation.pptx",
146
+ "slideNumber": 3,
147
+ "targetShapeName": "Content Placeholder 2",
148
+ "text": "New content",
149
+ "clearExistingText": true
150
+ }}
151
+ ```
152
+
153
+ **When to use `clearExistingText: true`:**
154
+ - Replacing slide content with new content
155
+ - Fixing content issues found by health check
156
+ - Updating existing bullet points
157
+ - Re-adding text after stripping bullet characters
158
+
159
+ **When to OMIT it (rare):**
160
+ - Intentionally appending to existing content (ask user first)
161
+
162
+ ---
163
+
164
+ ## Seamless Create-to-Edit Workflow
165
+
166
+ ```
167
+ 1. CREATE -> Generator creates .pptx file
168
+ 2. OPEN -> /ppt/open-attach (windowless unless the user asked to see the deck)
169
+ 3. ANALYZE -> /ppt/analyze-slide-content (if edits needed)
170
+ 4. EDIT -> /ppt/* endpoints
171
+ 5. VERIFY -> /ppt/review-slides, then offer an Agent review
172
+ ```
173
+
174
+ ### Example: Create then Edit
175
+
176
+ ```
177
+ // Step 1: Create the presentation with generator
178
+ ExecuteSkillApi:
179
+ endpoint: "/ppt-gen/generate"
180
+ body: { "options": {...}, "slides": [...] }
181
+ toolName: "Generate Presentation"
182
+ description: "Creating the presentation from scratch"
183
+ ```
184
+
185
+ ```json
186
+ // Step 2: Open in PowerPoint
187
+ {
188
+ "endpoint": "/ppt/open-attach",
189
+ "body": {
190
+ "filePath": "C:/Users/me/Documents/Q4_Review.pptx"
191
+ }
192
+ }
193
+
194
+ // Step 3: Analyze slide 2 to get shape names
195
+ {
196
+ "endpoint": "/ppt/analyze-slide-content",
197
+ "body": {
198
+ "filePath": "C:/Users/me/Documents/Q4_Review.pptx",
199
+ "slideNumbers": [2]
200
+ }
201
+ }
202
+ // Response: { "slides": [{ "slideNumber": 2, "shapeNames": ["Title 1", "Content Placeholder 2"] }] }
203
+
204
+ // Step 4: Add text to the slide
205
+ {
206
+ "endpoint": "/ppt/add-text-to-slide",
207
+ "body": {
208
+ "filePath": "C:/Users/me/Documents/Q4_Review.pptx",
209
+ "slideNumber": 2,
210
+ "targetShapeName": "Content Placeholder 2",
211
+ "text": "- Key finding 1\n- Key finding 2\n- Key finding 3"
212
+ }
213
+ }
214
+
215
+ // Step 5: Health check (then offer an Agent review)
216
+ {
217
+ "endpoint": "/ppt/review-slides",
218
+ "body": {
219
+ "filePath": "C:/Users/me/Documents/Q4_Review.pptx"
220
+ }
221
+ }
222
+ // Response includes diagnostic info - YOU decide how to fix based on context
223
+ ```
224
+
225
+ ---
226
+
227
+ ## Health Check (AUTOMATIC) & Review (ASK USER)
228
+
229
+ ### Health Check - Always Run Automatically
230
+ **After creating/editing presentations, ALWAYS run the health check yourself:**
231
+ ```json
232
+ endpoint: "/ppt/review-slides"
233
+ body: { "filePath": "..." }
234
+ ```
235
+ This catches technical issues: overlapping shapes, out of bounds, empty placeholders, text overflow, double bullets, font hierarchy, empty lines.
236
+ - **If issues found** → Fix them yourself using `issue-fix-mapping.md` in the one corrective pass (SKILL.md Core Principle 4); if the user asked for a content review, run it first and fix both in that pass. Re-run once and report what remains.
237
+ - **No issues** → Proceed to ask about full review
238
+
239
+ ### Full Review - Ask User First
240
+ **For non-trivial presentations: ASK the user if they want a full review via `Agent` with `agent_type: "review"`.** If the user already asked for a review, run it now without asking.
241
+
242
+ Trivial = ≤2 slides with simple bullet content.
243
+
244
+ **After health check passes, ask the user:**
245
+ "Would you like me to do a full content review of the presentation before we're done?"
246
+ - If user says yes → call `Agent` with `agent_type: "review"`
247
+ - If user says no or wants to skip → inform user the presentation is ready
248
+
249
+ **The Agent review runs these additional checks:**
250
+ 1. **Content Review**: Accuracy, visual consistency, spelling, slide flow
251
+ 2. **Fact-check** via WebSearch if presentation contains claims
252
+
253
+ **After the Agent review completes:** its blocking findings join the request's one corrective pass (SKILL.md Core Principle 4), together with any open health-check findings; re-check only the changed slides. Fix them with `issue-fix-mapping.md`, report minor ones to the user. Do not start another full review unless the user asks for one.
254
+
255
+ 📄 **Fix patterns**: Load `<skill-path>/issue-fix-mapping.md` for detailed fixes.
256
+
257
+ ---
258
+
259
+ ### Issue → Fix Mapping (Load When Fixing Issues)
260
+
261
+ **📄 Load `<skill-path>/issue-fix-mapping.md` when you need to fix health check issues.**
262
+
263
+ This separate file contains detailed fix patterns for every issue type:
264
+ - **STYLING ISSUES**: Double bullets, underline, subtitle formatting, empty lines, bullet counts, font hierarchy
265
+ - **TEXT ISSUES**: Small fonts, empty placeholders, template text
266
+ - **LAYOUT ISSUES**: Overlapping shapes, out of bounds, text overflow, empty slides
267
+ - **CONTENT ISSUES**: Empty tables
268
+ - **FORMATTING ISSUES**: Font consistency
269
+ - **IMAGE ISSUES**: Broken linked images
270
+
271
+ **Quick Reference (most common):**
272
+
273
+ | Issue | Quick Fix |
274
+ |-------|-----------|
275
+ | Double bullets | Re-add text without leading `- ` or `• ` chars, use `clearExistingText: true` |
276
+ | Subtitle not bold | `/ppt/format-slide-content` with `bold: true` |
277
+ | Font too small | `/ppt/format-slide-content` with `fontSize: 18` (min 14pt) |
278
+ | Text overflow | `/ppt/format-slide-content` with smaller `fontSize` |
279
+ | Empty placeholder | Windows: `/ppt/optimize-slide` with `deleteEmpty: true`. macOS: the delete half is not supported — the autofit runs and a `warning` says nothing was removed; hide the placeholder with `/ppt/format-shape` `visible: false`, or leave it empty |
280
+ | Overlapping shapes | `/ppt/format-shape` with new `left`/`top` position |
281
+
282
+ ---
283
+
284
+ ### Health Check Response
285
+
286
+ ```json
287
+ {
288
+ "success": true,
289
+ "review": {
290
+ "summary": {
291
+ "totalSlides": 10,
292
+ "slidesReviewed": 10,
293
+ "issuesFound": 3,
294
+ "warningsFound": 2,
295
+ "criticalIssues": 1
296
+ },
297
+ "slides": [
298
+ {
299
+ "slideNumber": 2,
300
+ "issues": [
301
+ {
302
+ "severity": "warning",
303
+ "category": "layout",
304
+ "message": "Shape overlaps with another shape",
305
+ "shapeName": "TextBox 1",
306
+ "recommendation": "Move or resize the shape"
307
+ }
308
+ ]
309
+ }
310
+ ],
311
+ "recommendations": ["Fix overlapping shapes on slide 2"]
312
+ }
313
+ }
314
+ ```
315
+
316
+ ## Common Editing Workflows
317
+
318
+ **📄 Load `<skill-path>/windows/examples/level-1-workflows.md` for detailed workflow examples.**
319
+
320
+ Contains step-by-step patterns for:
321
+ - Create presentation from scratch
322
+ - Edit existing presentation
323
+ - Duplicate and modify slides (template pattern)
324
+ - Insert tables and charts
325
+ - Extract data (ALWAYS use `/ppt/extract-slide-data`, NOT scripts)
326
+ - Apply theme and format
327
+
328
+ **Quick patterns:**
329
+
330
+ | Task | Key Steps |
331
+ |------|-----------|
332
+ | Edit slide | Open → Analyze → Add text with `clearExistingText: true` → Health check → offer Agent review |
333
+ | Insert slide (custom theme) | Open → Insert → Add title/content → Health check → offer Agent review |
334
+ | Insert slide (no custom theme) | Open → Duplicate closest matching slide → Replace content with `clearExistingText: true` → Health check → offer Agent review |
335
+ | Duplicate slides | Duplicate → Modify ONLY what changes (content already copied!) → Health check → offer Agent review of new slide|
336
+ | Extract data | Use `/ppt/extract-slide-data` (NEVER scripts) |
337
+ | Add image | `/ppt/insert-image` — Windows: use `targetShapeName` for placeholders, or `left`/`top`/`width` for free positioning. macOS: `targetShapeName` isn't supported (smart positioning is used instead, with a `warning` in the response); use `left`/`top`/`width` for exact placement |
338
+ | Apply theme (editing) | `/ppt/apply-theme` (for creation use `themePath` in generator) → Health check → offer Agent review of theme|
339
+
340
+ ---
341
+
342
+ ## Theme Detection & Slide Insertion Strategy
343
+
344
+ `/ppt/get-presentation-info` returns `themeName` and optionally `themeWarning`.
345
+
346
+ ### Why This Matters
347
+
348
+ Many presentations have visual styling (colors, fonts, backgrounds) applied manually or via a template — but no real PowerPoint theme. The underlying theme is still "Office Theme". When you insert a new slide with `/ppt/insert-slide`, it inherits from the **theme**, not from the existing slides. Result: a plain white/black slide that breaks visual consistency.
349
+
350
+ ### Decision Rule
351
+
352
+ After calling `/ppt/get-presentation-info`, check if `themeWarning` is present:
353
+
354
+ | `themeWarning` | Slide insertion strategy |
355
+ |---|---|
356
+ | absent | `/ppt/insert-slide` is safe — new slides inherit the theme's styling |
357
+ | present | **MUST** use duplicate-slide + replace content (not insert-slide) |
358
+
359
+ ### Workflow When `themeWarning` is present
360
+
361
+ 1. Identify the existing slide whose layout/styling best matches what you need
362
+ 2. Duplicate it: `/ppt/duplicate-slides` with `startSlideNumber` of that slide
363
+ 3. Replace content on the duplicated slide using `/ppt/add-text-to-slide` with `clearExistingText: true`
364
+ 4. Update images with `/ppt/replace-image` or `/ppt/insert-image` as needed
365
+
366
+ **Edge case:** If the presentation has 0 slides, `/ppt/insert-slide` is the only option (nothing to duplicate).
367
+
368
+ ---
369
+
370
+ ## Match Existing Styling (MANDATORY when editing generated presentations)
371
+
372
+ Generated presentations use theme-specific fonts/sizes/colors. Before editing:
373
+ 1. `/ppt/analyze-slide-content` on a nearby slide → note font, size, color
374
+ 2. When replacing text: match font/size/color exactly from analyze response
375
+ 3. When duplicating slides: only change content, keep formatting
376
+ 4. When inserting slides: copy font/size/color from existing slides of same layout type
377
+
378
+ Do NOT use default PowerPoint fonts when the deck uses generator styling.
379
+
380
+ ---
381
+
382
+ ## Best Practices for Editing (ExecuteSkillApi) - MANDATORY
383
+
384
+ 1. **Always open first** - Call `/ppt/open-attach` before any other endpoint
385
+ 2. **Analyze before first edit** - Get shape names before modifying a slide for the first time
386
+ 3. **Use exact shape names** - Copy them exactly from analyze response
387
+ 4. **Shape names are case-sensitive** - "Title 1" != "title 1"
388
+ 5. **Remove bullet chars from text** - if shape has bullet formatting, don't add "- " or "• "
389
+ 6. **Check font hierarchy** - titles must be larger than body text
390
+ 7. **Match existing styling** - inspect nearby slides for font/size/color before adding content (see section above)
391
+ 8. **Verify once, then hand over** - SKILL.md Core Principle 4
392
+ 9. **Auto-save is enabled** - Changes persist automatically
393
+
394
+ ---
395
+
396
+ ## Troubleshooting
397
+
398
+ | Error | Cause | Solution |
399
+ |-------|-------|----------|
400
+ | `File already exists` | Generator output path exists | Use different filename or delete existing |
401
+ | `Shape not found` | Wrong shape name | Run `/ppt/analyze-slide-content` to get exact names |
402
+ | `No active presentation` | File not open | Call `/ppt/open-attach` first |
403
+ | `Module not found` | pptxgenjs not loaded | Ensure using ExecuteSkillApi with `/ppt-gen/*` endpoints |
404
+ | `Slide not found` | Invalid slide number | Slide numbers are 1-based (first slide = 1) |
405
+
406
+ ---
407
+
408
+ ## Charts with Dark Themes (Auto-Handled)
409
+
410
+ **Background:** Charts don't inherit PowerPoint theme text colors - they historically used default black text regardless of background.
411
+
412
+ **Good News - Now Auto-Fixed on Windows:**
413
+
414
+ The `/ppt/insert-chart` endpoint now **automatically detects** the slide background color and applies appropriate contrasting text colors to chart elements (legend, title, axis labels):
415
+
416
+ - **Dark backgrounds** (luminance < 50%): White text is applied automatically
417
+ - **Light backgrounds** (luminance >= 50%): Black text is applied automatically
418
+
419
+ **Workflow (Simplified):**
420
+ 1. `/ppt/insert-chart` - Insert the chart (colors auto-adjusted based on background)
421
+ 2. `/ppt/review-slides` - Verify visibility
422
+
423
+ **Manual Override (if needed, Windows only):**
424
+ If you need custom colors, use `/ppt/execute-script` with C# code to set specific chart text colors. `/ppt/execute-script` doesn't exist on macOS — recreate the chart with different insert-chart parameters instead.