@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,433 @@
1
+ # Excel Styling, Features & Advanced Operations Reference
2
+
3
+ This file contains UI Automation tips, keyboard shortcuts, number formats, Big Four/McKinsey style guide, complete styling workflows, pivot tables, and chart best practices. **Read this before formatting, creating pivots/charts, or using UI Automation.**
4
+
5
+ ---
6
+
7
+ ## UI Automation Tips (CRITICAL)
8
+
9
+ ### Zoom Level for Cell Targeting (Both Platforms)
10
+
11
+ If you have difficulty clicking on specific cells or small UI elements, **increase zoom to 125%**:
12
+ - View → Zoom → 125%
13
+ - Or use Cmd+scroll (macOS) / Ctrl+scroll (Windows) to zoom in
14
+ - Higher zoom makes cells larger and easier to target accurately
15
+ - **Recommended**: Set zoom to 125% at the start of any Excel styling task
16
+
17
+ ### Color Picker Behavior
18
+
19
+ **macOS:** The color picker opens in a **SEPARATE Excel window** (often titled "Font Color"):
20
+ 1. Select cells in main workbook
21
+ 2. Click Fill Color dropdown arrow in ribbon
22
+ 3. Check AvailableApplicationWindows for new Excel window
23
+ 4. **Switch to that color picker window** (AppAct with that window identifier)
24
+ 5. Use keyboard navigation: `[k(down)][k(right)][k(right)][k(right)][k(enter)]`
25
+ 6. Window auto-closes, color is applied
26
+
27
+ **CRITICAL:** Never try keyboard on main workbook when color picker is open—it will navigate cells!
28
+
29
+ **Windows:** The color picker stays in the same window, but keyboard navigation is still recommended over clicking small color squares.
30
+
31
+ ### Shift Key Issues with Formula Entry
32
+
33
+ When typing formulas with absolute references like `$F$5`:
34
+
35
+ | Problem | Cause | Solution |
36
+ |---------|-------|----------|
37
+ | `$F%5` instead of `$F$5` | Shift held for `$` catches the `5` | Release Shift before typing numbers |
38
+ | `$F^6` instead of `$F$6` | Shift+6 = `^` | Release Shift before typing `6` |
39
+ | `#NAME?` errors | Invalid characters in formula | Check for `%` or `^` typos |
40
+
41
+ **Correct technique**: Type `$`, release Shift, type `F`, type `$`, release Shift, type `5`
42
+
43
+ ---
44
+
45
+ ## Keyboard Shortcuts (Both Platforms)
46
+
47
+ ### Navigation
48
+ | Action | macOS | Windows |
49
+ |--------|-------|---------|
50
+ | Go to cell A1 | `Cmd+Home` or `Ctrl+Fn+Left` | `Ctrl+Home` |
51
+ | Go to last cell | `Cmd+End` or `Ctrl+Fn+Right` | `Ctrl+End` |
52
+ | Jump to data edge | `Cmd+Arrow` | `Ctrl+Arrow` |
53
+ | Go to specific cell | Click Name Box → type ref → Enter | Same |
54
+ | Switch worksheets | `Ctrl+Page Up/Down` or `Fn+Ctrl+Up/Down` | `Ctrl+Page Up/Down` |
55
+
56
+ ### Selection
57
+ | Action | macOS | Windows |
58
+ |--------|-------|---------|
59
+ | Select entire column | `Ctrl+Space` | `Ctrl+Space` |
60
+ | Select entire row | `Shift+Space` | `Shift+Space` |
61
+ | Extend to data edge | `Cmd+Shift+Arrow` | `Ctrl+Shift+Arrow` |
62
+ | Select current region | `Cmd+Shift+*` | `Ctrl+Shift+*` |
63
+
64
+ ### Editing
65
+ | Action | macOS | Windows |
66
+ |--------|-------|---------|
67
+ | Edit cell | `F2` | `F2` |
68
+ | New line in cell | `Option+Enter` | `Alt+Enter` |
69
+ | AutoSum | `Cmd+Shift+T` | `Alt+=` |
70
+ | Fill down | `Cmd+D` | `Ctrl+D` |
71
+ | Fill right | `Cmd+R` | `Ctrl+R` |
72
+ | Toggle absolute ref | `F4` (while editing) | `F4` |
73
+
74
+ ### Formatting
75
+ | Action | macOS | Windows |
76
+ |--------|-------|---------|
77
+ | Format Cells dialog | `Cmd+1` | `Ctrl+1` |
78
+ | Bold | `Cmd+B` | `Ctrl+B` |
79
+ | Currency format | `Ctrl+Shift+$` | `Ctrl+Shift+$` |
80
+ | Percentage format | `Ctrl+Shift+%` | `Ctrl+Shift+%` |
81
+ | Create table | `Cmd+T` | `Ctrl+T` |
82
+
83
+ ---
84
+
85
+ ## UIA Fallback Guidance
86
+
87
+ **UIA needs Excel on screen.** Everything in the `/excel/*` API works with Excel hidden, which is the default — but UI Automation drives the actual window, so re-open with `"visible": true` before any of the following, and tell the user why Excel is appearing.
88
+
89
+ Use UI Automation (AppAct) when:
90
+
91
+ 1. **Ribbon Operations** - Format Painter, Conditional Formatting dialogs, Advanced features
92
+ 2. **Color Picker** - Custom colors not in API palette
93
+ 3. **Dialogs** - Print Preview, Page Setup, Import wizards
94
+ 4. **Add-ins** - Third-party add-in interactions
95
+ 5. **Visual Verification** - Screenshot to confirm result
96
+ 6. **API Failure** - As fallback when native API fails
97
+
98
+ Reach for 1–4 only when the API genuinely cannot do it. For 5, prefer `get-status` and `read-range`: they inspect the workbook itself, need no window, and tell you what the data actually is rather than what it looks like.
99
+
100
+ **UIA Best Practices:**
101
+ - Always target specific elements, not coordinates
102
+ - Wait for dialogs to fully load before interacting
103
+ - Use keyboard shortcuts when possible (Ctrl+B for bold)
104
+ - Take screenshot after for verification if uncertain
105
+
106
+ ---
107
+
108
+ ## Navigation via Name Box
109
+
110
+ ```json
111
+ {
112
+ "actions": [
113
+ {"type": "click", "payload": {"elementDescription": "Name Box showing cell reference"}},
114
+ {"type": "text_type", "payload": {"value": "B15"}},
115
+ {"type": "key_press", "payload": {"keys": "[k(enter)]"}}
116
+ ]
117
+ }
118
+ ```
119
+
120
+ ---
121
+
122
+ ## Number Format Codes
123
+
124
+ | Format | Code | Example Result |
125
+ |--------|------|----------------|
126
+ | Currency | `$#,##0.00` | $1,234.56 |
127
+ | Percentage | `0.00%` | 12.34% |
128
+ | Accounting | `_($* #,##0.00_)` | $ 1,234.56 |
129
+ | Date | `mm/dd/yyyy` | 01/15/2024 |
130
+ | Date (Long) | `mmmm d, yyyy` | January 15, 2024 |
131
+ | Number | `#,##0` | 1,234 |
132
+ | Decimal | `0.00` | 1234.56 |
133
+
134
+ ---
135
+
136
+ ## Big Four / McKinsey Style Guide
137
+
138
+ Professional consulting-style formatting:
139
+
140
+ ### Color-Coding Convention (Industry Standard)
141
+ | Cell Type | Font Color | Background | Purpose |
142
+ |-----------|------------|------------|---------|
143
+ | Hard-coded inputs | **Blue (#0000FF)** | White/Light Yellow | Manual entry, assumptions — numbers users will change for scenarios |
144
+ | Formulas (same sheet) | **Black (#000000)** | White | ALL formulas and calculations |
145
+ | Links to other sheets | **Green (#008000)** | White | Cross-sheet references within same workbook |
146
+ | External links | **Red (#FF0000)** | White | Links to other files |
147
+ | Key assumptions | Black | **Yellow (#FFFF00)** | Cells needing attention or update |
148
+ | Output/Results | Black (Bold) | Light Gray (#D9D9D9) | Summary cells |
149
+ | Headers | White (Bold) | Dark Blue (#4472C4) | Section headers |
150
+
151
+ Use the `financial` theme in the Generator to get these conventions automatically (negatives in parentheses, zeros as "-", standard fonts).
152
+
153
+ ### Number Formatting Standards
154
+ | Data Type | Format | Example |
155
+ |-----------|--------|---------|
156
+ | **Years** | Text (not number) | "2024" not "2,024" |
157
+ | **Currency** | `$#,##0;($#,##0);"-"` — units in headers | "Revenue ($mm)" |
158
+ | **Zeros** | Dash "-" for all zero values | `-` not `0` or `$0` |
159
+ | **Percentages** | `0.0%` — one decimal | 12.5% |
160
+ | **Multiples** | `0.0x` | 8.5x (EV/EBITDA, P/E) |
161
+ | **Negative numbers** | Parentheses | (123) not -123 |
162
+
163
+ ### Documentation Requirements for Hardcoded Values
164
+ When the workbook contains hardcoded data, add cell comments citing the source:
165
+
166
+ **Format:** `Source: [System/Document], [Date], [Specific Reference], [URL if applicable]`
167
+
168
+ **Examples:**
169
+ - `Source: Company 10-K, FY2024, Page 45, Revenue Note`
170
+ - `Source: Bloomberg Terminal, 2025-08-15, AAPL US Equity`
171
+ - `Source: FactSet, 2025-08-20, Consensus Estimates Screen`
172
+
173
+ Use the `comment` field on formatted cells or add a "Sources" column in data tables.
174
+
175
+ ### Visual Standards
176
+ | Element | Style |
177
+ |---------|-------|
178
+ | **Headers** | Dark blue bg (#4472C4), white bold text, centered |
179
+ | **Data Rows** | Alternating white/light gray, left-aligned |
180
+ | **Numbers** | Right-aligned, appropriate decimal places |
181
+ | **Currency** | Accounting format with $ symbol |
182
+ | **Borders** | Thin gray, headers have bottom border |
183
+ | **Fonts** | Calibri 10-11pt for data, 12pt for headers |
184
+
185
+ ### Layout Standards
186
+
187
+ **Sheet Organization:**
188
+ ```
189
+ Sheet 1: Cover/Summary Dashboard
190
+ Sheet 2: Inputs & Assumptions (Blue font)
191
+ Sheet 3: Model/Calculations (Black font)
192
+ Sheet 4: Outputs/Results (Bold)
193
+ Sheet 5: Charts
194
+ Sheet 6: Raw Data/Appendix
195
+ ```
196
+
197
+ **Section Structure:**
198
+ ```
199
+ Row 1-2: Title and Subtitle (Bold, larger font)
200
+ Row 3: Blank (breathing room)
201
+ Row 4: Column Headers (Bold, Bottom Border, Dark Fill)
202
+ Row 5+: Data rows
203
+ [Blank row between sections]
204
+ Last row: Totals (Bold, Top Border)
205
+ ```
206
+
207
+ ### Big Four Color Palette
208
+
209
+ | Color Name | Hex | RGB | Use Case |
210
+ |------------|-----|-----|----------|
211
+ | `header` | #4472C4 | (68, 114, 196) | Header rows |
212
+ | `input` | #FFFF99 | (255, 255, 153) | Input/assumption cells |
213
+ | `output` | #D9D9D9 | (217, 217, 217) | Output/result cells |
214
+ | `accent` | #BDD7EE | (189, 215, 238) | Accent/highlight |
215
+ | `error` | #FFC7CE | (255, 199, 206) | Error highlighting |
216
+
217
+ ---
218
+
219
+ ## Complete Styling Workflows
220
+
221
+ ### Workflow 1: Create Professional Dashboard
222
+
223
+ **Goal:** Build a sales dashboard with proper styling
224
+
225
+ ```
226
+ Phase 1: Structure (Native API/paste_content)
227
+ ─────────────────────────────────────────────
228
+ 1. Create/open workbook
229
+ 2. Paste data structure with formulas:
230
+ - Headers with bold (font-weight:bold)
231
+ - Input data with blue font (color:#0000FF)
232
+ - Formula columns: =SUM(B{row}:D{row})
233
+
234
+ Phase 2: Formatting (API or Scripts)
235
+ ──────────────────────────────────────
236
+ 3. Apply header style (dark blue bg #4472C4, white text)
237
+ 4. Apply borders to data range
238
+ 5. Format currency columns
239
+ 6. Auto-fit all columns
240
+ 7. Freeze header row (row 1)
241
+
242
+ Phase 3: Visual Polish (UIA if needed)
243
+ ────────────────────────────────────────
244
+ 8. Apply conditional formatting for highlights
245
+ 9. Add chart with proper X-axis labels
246
+ 10. Position chart to avoid overlaps
247
+
248
+ Phase 4: Validation
249
+ ────────────────────
250
+ 11. Health check for errors
251
+ 12. Verify with get-status / read-range (no window needed; a screenshot would
252
+ require making Excel visible, so only do that if the user asked to see it)
253
+ 13. Save workbook
254
+ ```
255
+
256
+ ### Workflow 2: Monthly Budget with Big Four Style
257
+
258
+ **Goal:** Professional budget tracker with consulting standards
259
+
260
+ ```
261
+ Phase 1: Data Entry (paste_content with styling)
262
+ ──────────────────────────────────────────────────
263
+ <table>
264
+ <tr><th style="font-weight:bold;">Category</th><th style="font-weight:bold;">Budget</th><th style="font-weight:bold;">Actual</th><th style="font-weight:bold;">Variance</th></tr>
265
+ <tr><td>Housing</td><td style="color:#0000FF;">2000</td><td style="color:#0000FF;">1950</td><td>=C2-B2</td></tr>
266
+ <tr><td>Utilities</td><td style="color:#0000FF;">300</td><td style="color:#0000FF;">325</td><td>=C3-B3</td></tr>
267
+ <tr><td style="font-weight:bold;">Total</td><td>=SUM(B2:B4)</td><td>=SUM(C2:C4)</td><td>=SUM(D2:D4)</td></tr>
268
+ </table>
269
+
270
+ Phase 2: Apply Big Four Styling
271
+ ──────────────────────────────────
272
+ 1. Select A1:D1 → Apply header style (dark blue bg, white text)
273
+ 2. Select all data → Apply borders
274
+ 3. Select B2:D5 → Format as currency
275
+ 4. Auto-fit columns
276
+ 5. Freeze row 1
277
+
278
+ Phase 3: Validation
279
+ ─────────────────────
280
+ 1. Change a Budget value → verify Variance updates (formulas work!)
281
+ 2. Verify totals are correct
282
+ 3. Health check
283
+ 4. Save
284
+ ```
285
+
286
+ ### Workflow 3: API + UIA Synergy Pattern
287
+
288
+ **When to use each approach:**
289
+
290
+ ```
291
+ API/Script First (90% of tasks):
292
+ ────────────────────────────────
293
+ ✅ Write data (write-range, write-ranges-batch, write-formulas-batch)
294
+ ✅ Basic formatting (format-range, auto-fit)
295
+ ✅ Charts with data ranges
296
+ ✅ Formulas and calculations
297
+ ✅ Conditional formatting (ContainsText, CellValue)
298
+
299
+ UIA Fallback (10% of tasks):
300
+ ──────────────────────────────
301
+ ✅ Ribbon interactions (Format Painter, advanced features)
302
+ ✅ Custom color picker (not in API palette)
303
+ ✅ Complex dialogs (Page Setup, Print Preview)
304
+ ✅ Visual verification (screenshot after operations)
305
+ ✅ When API fails or feature not available
306
+ ```
307
+
308
+ **Example: Column Chart with Proper Labels**
309
+ ```json
310
+ {
311
+ "endpoint": "/excel/add-chart-from-range",
312
+ "body": {
313
+ "sheetName": "Dashboard",
314
+ "valueRange": "B2:D5",
315
+ "xLabelRange": "A2:A5",
316
+ "chartType": "xlColumnClustered",
317
+ "title": "Q4 Sales by Region",
318
+ "width": 550,
319
+ "height": 350
320
+ }
321
+ }
322
+ ```
323
+
324
+ ---
325
+
326
+ ## Pivot Tables
327
+
328
+ **When the user asks for a "pivot table", ALWAYS create an actual Excel PivotTable using the `/excel/create-pivot-table` endpoint.** Do NOT manually compute values and write them as a static table — that defeats the purpose of a pivot table (dynamic, interactive, auto-updating).
329
+
330
+ ### When to Use Pivot Tables
331
+ - User explicitly says "pivot table"
332
+ - User wants to summarize/aggregate data by categories (e.g., "show sales by department")
333
+ - User wants percentage breakdowns, counts, averages grouped by fields
334
+ - User wants cross-tabulation (rows x columns)
335
+
336
+ ### Endpoint: `/excel/create-pivot-table`
337
+
338
+ ```json
339
+ {
340
+ "endpoint": "/excel/create-pivot-table",
341
+ "body": {
342
+ "sourceSheetName": "Data",
343
+ "sourceRange": "A1:E100",
344
+ "pivotSheetName": "PivotAnalysis",
345
+ "pivotTableName": "SalesPivot",
346
+ "rowFields": ["Department"],
347
+ "columnFields": ["Region"],
348
+ "dataFields": [
349
+ {"field": "Revenue", "function": "sum"},
350
+ {"field": "Units", "function": "average"}
351
+ ],
352
+ "filterFields": ["Year"]
353
+ }
354
+ }
355
+ ```
356
+
357
+ ### Parameters
358
+ | Parameter | Required | Description |
359
+ |-----------|----------|-------------|
360
+ | `sourceSheetName` | Yes | Sheet containing the source data |
361
+ | `sourceRange` | Yes | A1-style range including headers (e.g., `A1:E100`) |
362
+ | `pivotSheetName` | No | Destination sheet name (auto-created if not exists, defaults to "PivotSheet") |
363
+ | `pivotTableName` | No | Name for the pivot table (auto-generated if omitted) |
364
+ | `rowFields` | No | Array of column header names for row labels |
365
+ | `columnFields` | No | Array of column header names for column labels |
366
+ | `dataFields` | Yes | Array of `{field, function, showAs}` — the values to aggregate |
367
+ | `filterFields` | No | Array of column header names for page/filter area |
368
+
369
+ ### Aggregation Functions
370
+ `sum` (default), `count`, `average`, `max`, `min`
371
+
372
+ ### Show Values As (Percentages)
373
+ Each data field object can include a `showAs` property to display values as percentages instead of raw numbers:
374
+ - `"percentOfTotal"` — % of Grand Total (most common for distribution/demographic tables)
375
+ - `"percentOfColumn"` — % of Column Total
376
+ - `"percentOfRow"` — % of Row Total
377
+ - `"normal"` (default) — raw aggregated values
378
+
379
+ **Example**: To show Sex distribution as percentages:
380
+ ```json
381
+ "dataFields": [{"field": "Sex", "function": "count", "showAs": "percentOfTotal"}]
382
+ ```
383
+ This eliminates the need for manual percentage conversion or UI automation.
384
+
385
+ ### Important: Destination Sheet
386
+ - **Use a dedicated sheet** for pivot tables (e.g., `pivotSheetName: "PivotAnalysis"`). The endpoint auto-creates the sheet if it doesn't exist.
387
+ - **Merged cells are automatically unmerged** on the destination sheet before pivot creation (merged cells cause errors). Cell content is preserved.
388
+ - You can place pivot tables on sheets that already have headers or data — pivots are auto-placed below existing content.
389
+
390
+ ### Multiple Pivot Tables
391
+ To create multiple pivot tables on the same sheet, call the endpoint multiple times with different `pivotTableName` values. Each pivot is automatically stacked below existing content with a gap row. Do NOT specify `topLeftCell` — let the auto-placement handle positioning.
392
+
393
+ ### Example: Demographic Profile with Percentage Pivot Tables
394
+ ```
395
+ 1. Read source data sheet to get column names and data range
396
+ 2. Create pivot table for Sex:
397
+ - rowFields: ["Sex"]
398
+ - dataFields: [{"field": "Sex", "function": "count"}]
399
+ 3. Create pivot table for Civil Status:
400
+ - rowFields: ["Civil Status"]
401
+ - dataFields: [{"field": "Civil Status", "function": "count"}]
402
+ 4. Format percentage columns after pivot creation
403
+ ```
404
+
405
+ ---
406
+
407
+ ## Chart Best Practices
408
+
409
+ ### Always Provide X-Axis Labels!
410
+
411
+ **Problem:** Charts show "1, 2, 3, 4" instead of category names
412
+
413
+ **Solution:** Use `xLabelRange` parameter
414
+
415
+ ```json
416
+ {
417
+ "valueRange": "B2:E5",
418
+ "xLabelRange": "A2:A5",
419
+ "chartType": "xlColumnClustered"
420
+ }
421
+ ```
422
+
423
+ Also accepts `categoryRange` as an alias for `xLabelRange`.
424
+
425
+ ### Chart Types
426
+
427
+ | Type | When to Use | Example |
428
+ |------|-------------|---------|
429
+ | `xlColumnClustered` | Compare categories | Regional sales comparison |
430
+ | `xlLine` | Show trends over time | Monthly revenue trend |
431
+ | `xlPie` | Show parts of whole | Market share by product |
432
+ | `xlBarClustered` | Long category names | Employee performance by department |
433
+ | `xlArea` | Cumulative totals | Stacked budget allocation |