@uipath/delegate-sdk 1.203.0 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,272 @@
1
+ # Excel Generator Reference — Schemas & Theme Colors
2
+
3
+ > **Platform:** macOS only. On Windows, use Live Excel (`/excel/*`) endpoints via C# Interop instead.
4
+
5
+ This file contains the generator call format, sheet type schemas, formal/creative theme behavior, and the full theme color reference table for follow-up edits. **Do not skip this file** — it is required for producing valid generator JSON and for matching theme styles when editing generated workbooks.
6
+
7
+ ---
8
+
9
+ ## When to use the Generator
10
+
11
+ New workbook from scratch → ALWAYS use the Generator (`/excel-gen/generate`). Faster, more reliable, no Excel install required. Do NOT use openpyxl, Python, or bash workarounds to create `.xlsx`.
12
+
13
+ ### Capabilities (complete in one call)
14
+ - Multiple sheets (dataTable, summary, dashboard, formatted)
15
+ - Formulas (any Excel formula incl. cross-sheet)
16
+ - Column/row formatting (widths, heights, number formats)
17
+ - Conditional formatting (color scales, data bars, icon sets, cell rules, top10, duplicateValues, containsText, expressions)
18
+ - Auto-filter, freeze panes (header or custom row/column position)
19
+ - Merged cells, cell styling (fonts, colors, borders, alignment)
20
+ - Named ranges, data validation / dropdowns
21
+ - Sheet protection, print settings
22
+ - Hyperlinks, cell comments, embedded images
23
+ - Total rows with per-column formula control
24
+ - Professional themes (consulting, modern, corporate, academic, minimal, financial)
25
+
26
+ Not produced by the Generator — add afterward via Live Excel: charts → `/excel/add-chart-from-range`; pivot tables → `/excel/create-pivot-table`. Slicers and VBA macros are unsupported.
27
+
28
+ ### Call format
29
+
30
+ Call via `ExecuteSkillApi` with the `operations` array:
31
+
32
+ ```json
33
+ {
34
+ "operations": [
35
+ {
36
+ "endpoint": "/excel-gen/generate",
37
+ "body": {
38
+ "options": {
39
+ "title": "Q4 Financial Report", "theme": "consulting", "outputPath": "/Users/me/Documents/report.xlsx",
40
+ "namedRanges": [{ "name": "TotalSales", "range": "Revenue!$D$2:$D$25" }],
41
+ "printSettings": { "orientation": "landscape", "fitToPage": true }
42
+ },
43
+ "sheets": [
44
+ { "name": "Revenue", "type": "dataTable", "headers": ["Region", "Q1", "Q2", "Total"], "rows": [["APAC", 3500000, 3800000, "=SUM(B2:C2)"]], "autoFilter": true, "freezeHeader": true }
45
+ ]
46
+ }
47
+ }
48
+ ],
49
+ "toolName": "Generate Workbook",
50
+ "description": "Creating Q4 Financial Report with revenue data"
51
+ }
52
+ ```
53
+
54
+ **Workbook `options`:**
55
+
56
+ | Field | Required | Description |
57
+ |-------|----------|-------------|
58
+ | title | **Yes** | Workbook title (call fails without it) |
59
+ | outputPath | **Yes** | Absolute path for the `.xlsx` |
60
+ | theme | No | Theme name (default `consulting`) |
61
+ | author, company | No | Document metadata |
62
+ | defaultColumnWidth, defaultRowHeight | No | Workbook-wide defaults |
63
+ | namedRanges | No | `[{name, range}]` — range must be fully qualified and absolute (`Sheet!$A$1:$A$9`) |
64
+ | printSettings | No | Workbook-wide print setup (see schema below); can also be set per sheet |
65
+
66
+ **Limits:** max 100 sheets per workbook, max 100,000 rows per sheet — the call errors above these.
67
+
68
+ **printSettings schema** (workbook-level or per-sheet): `orientation` ("portrait"/"landscape"), `paperSize` (number), `fitToPage` (boolean), `fitToWidth`/`fitToHeight` (pages), `margins` ({top, bottom, left, right, header, footer}), `printArea` ("A1:H40"), `repeatRows` ({from, to}), `headerFooter` ({oddHeader, oddFooter}).
69
+
70
+ List themes: `{ "operations": [{ "endpoint": "/excel-gen/list-themes", "body": {} }], "toolName": "List Themes", "description": "..." }`
71
+
72
+ **Themes:** `consulting` (navy, Calibri), `modern` (teal, Aptos), `corporate` (dark blue, Cambria), `academic` (black, Times New Roman), `minimal` (gray, Helvetica Neue), `financial` (navy, Calibri 10pt, parentheses for negatives).
73
+
74
+ ### Large payloads → `bodyFromFile`
75
+
76
+ `/excel-gen/generate` accepts `bodyFromFile` (absolute path to a JSON file) instead of inline `body`. Apply when the spec hits the SKILL.md threshold (≥ 5 sheets OR any sheet ≥ 50 rows). See SKILL.md "Read once, build once" for the static (`WriteFile`) vs repetitive (Node script) recipe.
77
+
78
+ ```json
79
+ { "operations": [{ "endpoint": "/excel-gen/generate", "bodyFromFile": "/tmp/workbook-<tag>.json" }], "toolName": "Generate Workbook", "description": "..." }
80
+ ```
81
+
82
+ Don't inline a 200-line generator spec, don't pre-draft it in `<thinking>`. Path is faster and survives the output budget.
83
+
84
+ ### Generate-Then-Enhance Workflow
85
+
86
+ For workbooks needing charts or pivot tables:
87
+ 1. `/excel-gen/generate` — create the complete workbook (data, formulas, formatting, themes)
88
+ 2. `/excel/open-or-attach-workbook` — open the generated `.xlsx`
89
+ 3. `/excel/add-chart-from-range` — add charts
90
+ 4. `/excel/create-pivot-table` — add pivot tables
91
+ 5. `/excel/save-workbook` — save
92
+
93
+ ---
94
+
95
+ ## Formal vs Creative Themes
96
+
97
+ All current themes are `formal: true` — they use sober, professional colors. Because every shipped theme is formal, the generator **never** colors sheet tabs; generated workbooks always get Excel's default tab appearance. This keeps colorful sheet tabs off professional financial reports and dashboards.
98
+
99
+ The generator therefore has no `tabColor` field. Tab color is an **editing** operation and **macOS only**: on macOS, generate the workbook first, then set tab colors with `/excel/set-tab-color` on the sheets that need them. On Windows there is no tab-color endpoint, so tab colors cannot be set at all — do not promise them there.
100
+
101
+ ---
102
+
103
+ ## Generator Sheet Type Schemas
104
+
105
+ **All sheets share:** `name` (string), `type` (string), `freezeHeader?` (boolean), `freezeRow?`, `freezeColumn?`, `columnWidths?` (Record<string, number>), `printSettings?` (per-sheet, same schema as workbook-level), `sheetProtection?`
106
+
107
+ - `columnWidths` keys are a single column letter (`"A"`) or a column range (`"B:H"`); values are widths in characters — e.g. `{"A": 16, "B:H": 15}`.
108
+ - `sheetProtection`: `{ "password?": string, "sheet?": boolean, "formatCells?": boolean, "formatColumns?": boolean, "insertRows?": boolean, "deleteRows?": boolean }`.
109
+ - `rowHeights?` (dataTable and formatted sheets): keys are a row number (`"3"`) or row range (`"2:5"`), values are heights in points — e.g. `{"3": 110}`.
110
+
111
+ ### `dataTable` — Traditional data table
112
+ ```json
113
+ {
114
+ "name": "Revenue", "type": "dataTable",
115
+ "headers": ["Region", "Q1", "Q2", "Total"],
116
+ "rows": [["APAC", 3500000, 3800000, "=SUM(B2:C2)"]],
117
+ "autoFilter": true, "freezeHeader": true,
118
+ "columnFormats": {"B": "$#,##0", "C": "$#,##0"},
119
+ "totalRow": {"label": "TOTAL", "formula": "SUM", "labelColumns": 1,
120
+ "columnOverrides": {"2": "AVERAGE", "3": "NONE"}},
121
+ "conditionalFormatting": [{"range": "B2:C10", "type": "colorScale"}],
122
+ "dataValidation": [{"range": "A2:A100", "type": "list", "formulae": ["APAC,EMEA,NA"]}]
123
+ }
124
+ ```
125
+
126
+ **`conditionalFormatting` rule schema** (dataTable sheets) — `range` + `type` plus type-specific fields:
127
+
128
+ | type | Fields |
129
+ |------|--------|
130
+ | colorScale | `min`, `mid`, `max` (hex colors, e.g. `"#F8696B"`, `"#FFEB84"`, `"#63BE7B"`) |
131
+ | dataBar | `color` (hex) |
132
+ | cellIs | `operator` ("greaterThan"/"lessThan"/"equal"/"between"), `formulae` (values), `style` |
133
+ | expression | `formulae` (formula string), `style` |
134
+ | iconSet | `iconSet` ("3Arrows", "3TrafficLights", "4Arrows", "5Arrows", "3Symbols", "4Rating", "5Rating") |
135
+ | top10 | `rank` (N), `percent` (true = top N%) |
136
+ | duplicateValues | `style` |
137
+ | containsText | `text`, `style` |
138
+
139
+ `style` shape: `{"font": {"color": "#RRGGBB", "bold": true}, "fill": {"bgColor": "#RRGGBB"}}`.
140
+
141
+ **`dataValidation` rule schema** (dataTable AND formatted sheets): `range`, `type` ("list"/"whole"/"decimal"/"date"/"textLength"/"custom"), `formulae`, plus optional `operator` ("between"/"greaterThan"/"lessThan"/"equal"), `allowBlank`, `showErrorMessage`, `errorTitle`, `error`, `showInputMessage`, `promptTitle`, `prompt`.
142
+
143
+ ### `summary` — Label-value pairs
144
+ ```json
145
+ {
146
+ "name": "Summary", "type": "summary",
147
+ "title": "Q4 Financial Summary",
148
+ "items": [
149
+ {"label": "Total Revenue", "value": 15000000, "format": "$#,##0"},
150
+ {"label": "Growth Rate", "value": 0.12, "format": "0.0%"}
151
+ ]
152
+ }
153
+ ```
154
+
155
+ ### `dashboard` — Multiple sections (KPI or table). REQUIRES `sections` array, NOT `rows`.
156
+ ```json
157
+ {
158
+ "name": "Dashboard", "type": "dashboard",
159
+ "sections": [
160
+ {
161
+ "title": "Key Metrics",
162
+ "items": [
163
+ {"label": "Revenue", "value": 15000000, "format": "$#,##0"},
164
+ {"label": "Margin", "value": 0.23, "format": "0.0%"}
165
+ ]
166
+ },
167
+ {
168
+ "title": "Top Products",
169
+ "headers": ["Product", "Revenue", "Units"],
170
+ "rows": [["Widget A", 5000000, 12000], ["Widget B", 3500000, 8500]]
171
+ }
172
+ ]
173
+ }
174
+ ```
175
+ - Section with `items` = KPI section (label-value pairs like summary)
176
+ - Section with `headers` + `rows` = table section (data table within dashboard)
177
+
178
+ ### `formatted` — Freeform cells with styles and merges
179
+ ```json
180
+ {
181
+ "name": "Cover", "type": "formatted",
182
+ "cells": [
183
+ {"cell": "A1", "value": "Q4 Report", "style": {"bold": true, "fontSize": 24, "fontColor": "#1F4E79"}},
184
+ {"cell": "A3", "value": "Long explanation text...", "style": {"wrapText": true, "verticalAlignment": "top"},
185
+ "comment": "Cell note text — renders as an Excel comment on the cell"},
186
+ {"cell": "A5", "value": "=SUM(Data!F2:F25)", "style": {"numberFormat": "$#,##0.00", "bold": true}},
187
+ {"cell": "B5", "value": {"hyperlink": "https://example.com", "text": "example.com"}, "style": {"fontColor": "#0563C1"}}
188
+ ],
189
+ "mergedRegions": [
190
+ {"range": "A1:F1", "value": "Q4 Report", "style": {"bold": true, "fontSize": 24, "bgColor": "#1F4E79", "fontColor": "#FFFFFF", "horizontalAlignment": "center"}}
191
+ ],
192
+ "images": [{"base64": "...", "type": "png", "position": {"tl": {"col": 0, "row": 5}}, "width": 400, "height": 200}],
193
+ "rowHeights": {"3": 110},
194
+ "dataValidation": [{"range": "C2:C20", "type": "list", "formulae": ["Yes,No"]}]
195
+ }
196
+ ```
197
+
198
+ - Cell `value` forms: string (a leading `=` makes it a live formula), number, boolean, or `{hyperlink, text}` for links.
199
+ - `comment?` (string) attaches an Excel cell note.
200
+ - **`style` (CellStyle) fields:** `bold?`, `italic?`, `fontSize?`, `fontName?`, `fontColor?` (hex), `bgColor?` (hex), `horizontalAlignment?` ("left"/"center"/"right"), `verticalAlignment?` ("top"/"middle"/"bottom"), `wrapText?` (boolean), `numberFormat?` (Excel format string), `border?` (boolean, theme borders). Nothing else — there is no underline or font-strike field.
201
+ - `images` entries: `type` ("png"/"jpeg"/"gif"), one of `base64` or `path` (absolute file path), `position.tl` `{col, row}` (0-based) with optional `position.br`, or `width`+`height` in pixels.
202
+
203
+ ---
204
+
205
+ ## totalRow & Cross-Sheet Formula Guide
206
+
207
+ **`columnOverrides` uses 0-based column indices** counting from the first header. With `labelColumns: 1`, column 0 is the label — override keys start at 1:
208
+
209
+ ```
210
+ Headers: [Region, Q1, Q2, Total, Growth%]
211
+ Index: 0 1 2 3 4
212
+ ```
213
+ - `"formula": "SUM"` applies SUM to all columns after `labelColumns`
214
+ - `"columnOverrides": {"3": "NONE", "4": "AVERAGE"}` skips Total, averages Growth%
215
+ - Custom formula: `"3": "=C{end}/C{start}"` — `{start}` and `{end}` resolve to first/last data row numbers
216
+
217
+ **Cross-sheet formulas in row data** — pass as strings starting with `=`:
218
+ ```json
219
+ "rows": [
220
+ ["Engineering", "=COUNTIF(Employees!B2:B13,\"Engineering\")",
221
+ "=SUMIF(Employees!B2:B13,\"Engineering\",Employees!D2:D13)", "=C2/B2"]
222
+ ]
223
+ ```
224
+ Escape inner quotes with `\"`. The generator preserves these as-is in the .xlsx output.
225
+
226
+ **Avoid these functions** — they cause `#NAME?` errors in Excel after file open:
227
+ - `MAXIFS` / `MINIFS` → use `=MAX(IF(range=criteria,values))` instead
228
+ - `MATCH(TRUE, range>value, 0)` → use `=MATCH(1,INDEX((range>value)*1,0),0)` instead
229
+ - Array formulas with nested `COUNTIF` inside `MAX` → pre-compute in helper cells
230
+
231
+ These newer functions are written correctly by the generator but Excel re-saves them with `_xludf.` prefix, breaking the formula.
232
+
233
+ ---
234
+
235
+ ## Theme Color Reference for Follow-Up Edits
236
+
237
+ **CRITICAL:** When editing a workbook after generation, you MUST match the theme used during generation. Use the exact colors and fonts below for any new sheets, tables, headers, or formatting added via `/excel/format-range`.
238
+
239
+ **How to determine the theme:** Check the conversation history for the `/excel-gen/generate` call — the `theme` field in the JSON spec tells you which theme was used. If not specified, the default is `consulting`.
240
+
241
+ | Theme | Header BG | Header Text | Alt Row | Border | Accent | Title/Body Text | Font (Header) | Font (Body) | Size |
242
+ |-------|-----------|-------------|---------|--------|--------|-----------------|---------------|-------------|------|
243
+ | `consulting` | `#2F5496` | `#FFFFFF` | `#D6E4F0` | `#B4C6E7` | `#4472C4` | `#2F5496` / `#333333` | Calibri Bold | Calibri | 11 |
244
+ | `modern` | `#0F7B6C` | `#FFFFFF` | `#E2F0ED` | `#A7D8D0` | `#0F7B6C` | `#0F7B6C` / `#374151` | Aptos Bold | Aptos | 11 |
245
+ | `corporate` | `#1B3A5C` | `#FFFFFF` | `#F2F2F2` | `#8FAABE` | `#C9A227` | `#1B3A5C` / `#2D2D2D` | Cambria Bold | Calibri | 11 |
246
+ | `academic` | `#1A1A1A` | `#FFFFFF` | `#F5F5F5` | `#AAAAAA` | `#8B0000` | `#1A1A1A` / `#1A1A1A` | Times New Roman Bold | Georgia | 11 |
247
+ | `minimal` | `#2D2D2D` | `#FFFFFF` | `#FAFAFA` | `#CCCCCC` | `#666666` | `#2D2D2D` / `#4A4A4A` | Helvetica Neue Bold | Helvetica Neue | 11 |
248
+ | `financial` | `#2F5496` | `#FFFFFF` | `#F2F2F2` | `#B4C6E7` | `#FFFF00` | `#2F5496` / `#000000` | Calibri Bold | Calibri | 10 |
249
+
250
+ **Applying theme formatting in follow-up edits:**
251
+ ```json
252
+ {
253
+ "endpoint": "/excel/format-range",
254
+ "body": {
255
+ "sheetName": "New Sheet",
256
+ "range": "A1:F1",
257
+ "bold": true,
258
+ "fontName": "Calibri",
259
+ "fontSize": 11,
260
+ "fontColorHtml": "#FFFFFF",
261
+ "interiorColorHtml": "#2F5496",
262
+ "applyThinBorders": true
263
+ }
264
+ }
265
+ ```
266
+
267
+ **Rules for follow-up edits:**
268
+ - New headers → use Header BG + Header Text from the theme
269
+ - New data rows → use Body Font at theme size, alternate rows with Alt Row color
270
+ - Borders → use Border color with thin style
271
+ - Titles → use Title Text color with Bold at size 16 (14 for `financial`)
272
+ - `financial` theme: also apply parentheses for negatives, dash for zeros (see Number Formatting Standards in `<skill-path>/styling-and-features.md`)
@@ -0,0 +1,242 @@
1
+ #!/usr/bin/osascript
2
+ (*
3
+ * Add Data Validation to Excel Range
4
+ * Applies data validation rules using JXA (JavaScript for Automation) for reliable API access.
5
+ *
6
+ * Usage: osascript add-data-validation.applescript <range> <validationType> [criteria] [sheetName]
7
+ *
8
+ * Parameters:
9
+ * range - The cell range to apply validation to (e.g., "B2:B100")
10
+ * validationType - Type of validation:
11
+ * "list" - Dropdown list from comma-separated values
12
+ * "whole_number" - Integer validation
13
+ * "decimal" - Decimal number validation
14
+ * criteria - Validation criteria:
15
+ * For "list": comma-separated values (e.g., "Yes,No,Maybe")
16
+ * For numeric: "between:min:max" or "greater_than:value" or "less_than:value"
17
+ * sheetName - Optional: Sheet name (default: active sheet)
18
+ *
19
+ * Examples:
20
+ * osascript add-data-validation.applescript "B2:B100" "list" "Yes,No,Maybe"
21
+ * osascript add-data-validation.applescript "C2:C50" "whole_number" "between:1:100"
22
+ * osascript add-data-validation.applescript "D2:D50" "decimal" "greater_than:0"
23
+ *
24
+ * Output:
25
+ * {"success":true,"range":"B2:B100","validationType":"list"}
26
+ *
27
+ * Note: Excel must be open with an active workbook.
28
+ *)
29
+
30
+ on run argv
31
+ if (count of argv) < 2 then
32
+ return "Error: Missing arguments. Usage: osascript add-data-validation.applescript <range> <validationType> [criteria] [sheetName]"
33
+ end if
34
+
35
+ set rangeAddress to item 1 of argv as string
36
+ set validationType to item 2 of argv as string
37
+ set criteria to ""
38
+ set sheetName to ""
39
+ -- Documented (advanced.md:108) errorMessage: shown by Excel on
40
+ -- invalid input. Round 12 wired through. Optional; "" means none.
41
+ set errorMessage to ""
42
+
43
+ if (count of argv) >= 3 then
44
+ set criteria to item 3 of argv as string
45
+ end if
46
+
47
+ if (count of argv) >= 4 then
48
+ set sheetName to item 4 of argv as string
49
+ end if
50
+
51
+ if (count of argv) >= 5 then
52
+ set errorMessage to item 5 of argv as string
53
+ end if
54
+
55
+ -- Validate inputs
56
+ if validationType is "list" and criteria is "" then
57
+ return "Error: List validation requires comma-separated values as criteria."
58
+ end if
59
+
60
+ if validationType is not "list" and validationType is not "whole_number" and validationType is not "decimal" and validationType is not "date" and validationType is not "time" and validationType is not "text_length" and validationType is not "custom" then
61
+ return "Error: Unsupported validationType: \"" & validationType & "\". Use: list, whole_number, decimal, date, time, text_length, custom"
62
+ end if
63
+
64
+ -- Parse numeric criteria
65
+ set opCode to 1
66
+ set val1 to "0"
67
+ set val2 to "100"
68
+ set opType to "between"
69
+ if validationType is "custom" then
70
+ -- Custom validation: criteria IS the formula (e.g.
71
+ -- "=AND(A1>0,A1<100)"). Do NOT run parseCriteria because the
72
+ -- formula may contain colons or commas the splitter would
73
+ -- mis-tokenise. Codex review on PR #3880 round 11 flagged this.
74
+ set val1 to criteria
75
+ set opType to "custom"
76
+ set opCode to 1
77
+ else if validationType is not "list" then
78
+ set parsedCriteria to my parseCriteria(criteria)
79
+ set opType to item 1 of parsedCriteria
80
+ set val1 to item 2 of parsedCriteria
81
+ set val2 to item 3 of parsedCriteria
82
+
83
+ -- Map operator names to VBA/JXA numeric codes
84
+ -- 1=Between, 2=NotBetween, 3=Equal, 4=NotEqual, 5=Greater, 6=Less, 7=GreaterEqual, 8=LessEqual
85
+ if opType is "between" then
86
+ set opCode to 1
87
+ else if opType is "not_between" then
88
+ set opCode to 2
89
+ else if opType is "equal" then
90
+ set opCode to 3
91
+ else if opType is "not_equal" then
92
+ set opCode to 4
93
+ else if opType is "greater_than" then
94
+ set opCode to 5
95
+ else if opType is "less_than" then
96
+ set opCode to 6
97
+ else if opType is "greater_equal" then
98
+ set opCode to 7
99
+ else if opType is "less_equal" then
100
+ set opCode to 8
101
+ else if opType is "custom" then
102
+ -- Custom validation passes the formula as formula1; opCode is
103
+ -- ignored by Excel for type 7, but xlValidateCustom expects the
104
+ -- operator field set to something valid (1 = between).
105
+ set opCode to 1
106
+ else
107
+ set opCode to 1
108
+ end if
109
+ end if
110
+
111
+ -- Map validation type to numeric code
112
+ -- 1=WholeNumber, 2=Decimal, 3=List, 4=Date, 5=Time, 6=TextLength, 7=Custom
113
+ set typeCode to 3
114
+ if validationType is "whole_number" then
115
+ set typeCode to 1
116
+ else if validationType is "decimal" then
117
+ set typeCode to 2
118
+ else if validationType is "list" then
119
+ set typeCode to 3
120
+ else if validationType is "date" then
121
+ set typeCode to 4
122
+ else if validationType is "time" then
123
+ set typeCode to 5
124
+ else if validationType is "text_length" then
125
+ set typeCode to 6
126
+ else if validationType is "custom" then
127
+ set typeCode to 7
128
+ end if
129
+
130
+ -- Build JXA code to apply validation. JXA literals embed user input
131
+ -- (sheet name, range, formula values, error message), so each value
132
+ -- MUST be a properly-escaped JS string literal. Codex review round
133
+ -- 12 flagged that the prior implementation only escaped single
134
+ -- quotes; backslashes (e.g. `C:\\temp\\new` in a list value) were
135
+ -- interpreted as JS escape sequences (`\t` becomes a tab). Use
136
+ -- jsLiteral() which escapes \\, ', \n, \r, \t, and the embedded
137
+ -- single-quote delimiter.
138
+ set jxaCode to "var excel = Application('Microsoft Excel');"
139
+
140
+ -- Resolve the target worksheet by NAME directly. The earlier path
141
+ -- did `activateObject(worksheet) ; sheet = activeWorkbook.activeSheet`
142
+ -- which depends on Excel's `activate` Apple Event actually flipping
143
+ -- the active sheet. macOS Excel routinely no-ops that activation,
144
+ -- so the rng below would target the wrong sheet. Codex review on
145
+ -- PR #3880 round 14 flagged the gap. Use the worksheet object
146
+ -- directly: `sheet.ranges[X]` works on any worksheet ref.
147
+ if sheetName is not "" then
148
+ set sheetLit to my jsLiteral(sheetName)
149
+ set jxaCode to jxaCode & "var sheet; try { sheet = excel.activeWorkbook.worksheets[" & sheetLit & "]; sheet.name(); } catch(e) { throw new Error('Sheet not found: ' + " & sheetLit & "); }"
150
+ else
151
+ set jxaCode to jxaCode & "var sheet = excel.activeWorkbook.activeSheet;"
152
+ end if
153
+
154
+ set rangeLit to my jsLiteral(rangeAddress)
155
+ set jxaCode to jxaCode & "var rng = sheet.ranges[" & rangeLit & "];"
156
+ set jxaCode to jxaCode & "try { rng.validation.delete(); } catch(e) {}"
157
+
158
+ -- Build the validation.add({...}) object, including the optional
159
+ -- errorMessage (`errorMessage`/`errorTitle`) when provided.
160
+ set errBlock to ""
161
+ if errorMessage is not "" then
162
+ set errLit to my jsLiteral(errorMessage)
163
+ set errBlock to ", showError: true, errorMessage: " & errLit
164
+ end if
165
+
166
+ if validationType is "list" then
167
+ set critLit to my jsLiteral(criteria)
168
+ set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, formula1: " & critLit & errBlock & "});"
169
+ else
170
+ set val1Lit to my jsLiteral(val1)
171
+ set val2Lit to my jsLiteral(val2)
172
+ if opType is "between" or opType is "not_between" then
173
+ set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, operator: " & opCode & ", formula1: " & val1Lit & ", formula2: " & val2Lit & errBlock & "});"
174
+ else
175
+ set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, operator: " & opCode & ", formula1: " & val1Lit & errBlock & "});"
176
+ end if
177
+ end if
178
+
179
+ set rangeLit2 to my jsLiteral(rangeAddress)
180
+ set typeLit to my jsLiteral(validationType)
181
+ set jxaCode to jxaCode & "JSON.stringify({success:true,range:" & rangeLit2 & ",validationType:" & typeLit & "});"
182
+
183
+ -- Execute JXA
184
+ try
185
+ set jxaResult to do shell script "osascript -l JavaScript -e " & quoted form of jxaCode
186
+ return jxaResult
187
+ on error errMsg
188
+ return "Error: " & errMsg
189
+ end try
190
+ end run
191
+
192
+ -- Parse criteria string into {operator, value1, value2}
193
+ on parseCriteria(criteriaStr)
194
+ if criteriaStr is "" then
195
+ return {"between", "0", "100"}
196
+ end if
197
+
198
+ set AppleScript's text item delimiters to ":"
199
+ set parts to text items of criteriaStr
200
+ set AppleScript's text item delimiters to ""
201
+
202
+ set partCount to count of parts
203
+
204
+ if partCount is 1 then
205
+ return {"greater_than", item 1 of parts, ""}
206
+ else if partCount is 2 then
207
+ return {item 1 of parts, item 2 of parts, ""}
208
+ else if partCount >= 3 then
209
+ return {item 1 of parts, item 2 of parts, item 3 of parts}
210
+ end if
211
+
212
+ return {"between", "0", "100"}
213
+ end parseCriteria
214
+
215
+ -- Helper function to replace text
216
+ on replaceText(theText, searchStr, replaceStr)
217
+ set AppleScript's text item delimiters to searchStr
218
+ set theItems to text items of theText
219
+ set AppleScript's text item delimiters to replaceStr
220
+ set theText to theItems as string
221
+ set AppleScript's text item delimiters to ""
222
+ return theText
223
+ end replaceText
224
+
225
+ -- Produce a JS-source string literal (single-quoted) safe to embed in
226
+ -- the JXA `do shell script "osascript -l JavaScript -e <code>"` payload.
227
+ -- Escapes backslash (FIRST), single quote, newline, carriage return,
228
+ -- and tab. Without this, user input containing backslashes (Windows
229
+ -- paths in list values, formulas) gets interpreted as JS escape
230
+ -- sequences and silently corrupts the validation rule. Codex review on
231
+ -- PR #3880 round 12 flagged the gap.
232
+ on jsLiteral(s)
233
+ set t to s as string
234
+ -- Order matters: escape backslashes FIRST so the escapes we add for
235
+ -- other chars don't get double-escaped.
236
+ set t to my replaceText(t, "\\", "\\\\")
237
+ set t to my replaceText(t, "'", "\\'")
238
+ set t to my replaceText(t, return, "\\n")
239
+ set t to my replaceText(t, linefeed, "\\n")
240
+ set t to my replaceText(t, tab, "\\t")
241
+ return "'" & t & "'"
242
+ end jsLiteral