@uipath/delegate-sdk 1.203.1 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,161 @@
1
+ # Excel Architect — macOS
2
+
3
+ macOS-specific Excel automation via **ExecuteSkillApi** endpoints (routed to AppleScript) and **UI Automation** fallback.
4
+
5
+ ## Creating new workbooks → Generator
6
+
7
+ New workbook from scratch → use the **Generator** (`/excel-gen/generate`); load `generator.md` for capabilities, call format, schemas, and themes. Faster, more reliable, no Excel install required. Do NOT use openpyxl, Python, or bash workarounds to create `.xlsx`. Editing an existing workbook → Live Excel (`/excel/*`) below.
8
+
9
+ ---
10
+
11
+ ## Execution Priority (macOS) — Live Excel Operations
12
+
13
+ | Priority | Approach | Tool | Speed | Best For |
14
+ |----------|----------|------|-------|----------|
15
+ | **1st** | API | ExecuteSkillApi | Fastest | Data writes, formulas, formatting, charts, batch ops |
16
+ | **2nd** | UIA | AppAct | Slower | Ribbon clicks, dialogs, color pickers |
17
+
18
+ macOS routes all `/excel/` API endpoints to AppleScript transparently.
19
+
20
+ ---
21
+
22
+ ## Available Scripts (AppleScript)
23
+
24
+ All scripts in `macos/scripts/`. Accessed via `ExecuteSkillApi` `/excel/*` endpoints (same as Windows).
25
+
26
+ #### Workbook Control
27
+ | Script | Endpoint | Description |
28
+ |--------|----------|-------------|
29
+ | `open-workbook.applescript` | `/excel/open-or-attach-workbook` | Open workbook file |
30
+ | `create-workbook.applescript` | `/excel/create-workbook` | Create new workbook |
31
+ | `list-open-workbooks.applescript` | `/excel/list-open-workbooks` | List all open workbooks |
32
+ | `get-current-file.applescript` | `/excel/get-workbook-info` | Get current workbook info |
33
+ | `workbook-lifecycle.applescript` | `/excel/save-workbook`, `/excel/close-workbook` | Save/close workbook |
34
+ | `maximize-window.applescript` | — | Maximize Excel window |
35
+
36
+ Omitting `saveBeforeClose` saves the workbook on both Windows and macOS. Pass explicit `saveBeforeClose: true` or `saveBeforeClose: false` whenever persistence intent matters: `true` saves before closing; `false` discards unsaved changes.
37
+
38
+ #### Sheet Operations
39
+ | Script | Endpoint | Description |
40
+ |--------|----------|-------------|
41
+ | `select-sheet.applescript` | `/excel/select-sheet` | Switch to sheet |
42
+ | `create-sheets.applescript` | `/excel/create-sheets` | Create new sheets |
43
+ | `delete-sheet.applescript` | `/excel/delete-sheet` | Delete sheet |
44
+ | `rename-sheet.applescript` | `/excel/rename-sheet` | Rename sheet |
45
+ | `set-tab-color.applescript` | `/excel/set-tab-color` | Set or clear a sheet tab color (**macOS only** — no Windows equivalent) |
46
+ | `get-sheet-dimensions.applescript` | `/excel/get-sheet-dimensions` | Get used range dimensions |
47
+
48
+ #### Read & Write Data
49
+ | Script | Endpoint | Description |
50
+ |--------|----------|-------------|
51
+ | `read-range.applescript` | `/excel/read-range` | Read cell values from range |
52
+ | `write-range.applescript` | `/excel/write-range` | Write values to range |
53
+ | `append-rows.applescript` | `/excel/append-rows` | Append rows after last data row |
54
+ | `clear-range.applescript` | `/excel/clear-range` | Clear cell contents |
55
+ | `copy-paste.applescript` | `/excel/copy-paste` | Copy/paste range |
56
+ | `find-replace.applescript` | `/excel/find-replace` | Find & replace across sheet/workbook |
57
+ | `write-formula.applescript` | `/excel/write-formula` | Write formula to cell(s) |
58
+
59
+ #### Formatting
60
+ | Script | Endpoint | Description |
61
+ |--------|----------|-------------|
62
+ | `format-range.applescript` | `/excel/format-range` | Format cells (font, color, borders, alignment) |
63
+ | `autofit-columns.applescript` | `/excel/auto-fit-columns` | Auto-fit column widths |
64
+ | `freeze-panes.applescript` | `/excel/freeze-panes` | Freeze rows/columns |
65
+ | `apply-conditional-format.applescript` | `/excel/conditional-formatting` | Conditional formatting rules |
66
+ | `add-data-validation.applescript` | `/excel/add-data-validation` | Data validation / dropdowns |
67
+ | `merge-cells.applescript` | `/excel/merge-cells` | Merge/unmerge cells |
68
+
69
+ #### Data Operations
70
+ | Script | Endpoint | Description |
71
+ |--------|----------|-------------|
72
+ | `sort-data.applescript` | `/excel/sort-range` | Sort data range |
73
+ | `filter-data.applescript` | `/excel/filter-range` | Filter data range |
74
+ | `create-pivot.applescript` | `/excel/create-pivot-table` | Create pivot table |
75
+
76
+ #### Charts & Health
77
+ | Script | Endpoint | Description |
78
+ |--------|----------|-------------|
79
+ | `create-chart.applescript` | `/excel/add-chart-from-range` | Create chart from data range |
80
+ | — (inline) | `/excel/delete-chart` | Delete one or all charts from a sheet |
81
+ | `health-check.applescript` | `/excel/get-status` | Health check |
82
+ | `undo.applescript` | `/excel/undo` | Undo the user's last manual edit (never API changes) |
83
+
84
+ ---
85
+
86
+ ## macOS Batch Syntax
87
+
88
+ These endpoints support batch mode on macOS:
89
+
90
+ | Endpoint | Batch Format |
91
+ |----------|-------------|
92
+ | `/excel/rename-sheet` | `{batch: [{oldName, newName}, ...]}` |
93
+ | `/excel/find-replace` | `{batch: [{findWhat, replaceWith, sheetName?}, ...]}` |
94
+ | `/excel/format-range` | `{batch: [{range, action, param, sheetName?}, ...]}` |
95
+ | `/excel/conditional-formatting` | `{batch: [{rule, value?, range?, sheetName?}, ...]}` |
96
+ | `/excel/merge-cells` | `{batch: [{range, action?, sheetName?}, ...]}` |
97
+
98
+ ---
99
+
100
+ ## macOS Preset Colors
101
+
102
+ Use these shorthand names in `interiorColorHtml` instead of hex codes:
103
+
104
+ | Preset | Hex | Use Case |
105
+ |--------|-----|----------|
106
+ | `header` | #4472C4 | Header row background |
107
+ | `accent` | #BDD7EE | Accent/highlight |
108
+ | `input` | #FFFF99 | Input cells |
109
+ | `output` | #D9D9D9 | Output/result cells |
110
+ | `error` | #FFC7CE | Error highlighting |
111
+
112
+ ---
113
+
114
+ ## macOS Limitations
115
+
116
+ Consult this table before promising a feature. If a requirement is marked unsupported, say so up front instead of retrying workarounds.
117
+
118
+ | Feature | Status |
119
+ |---------|--------|
120
+ | `/excel/execute-script` | **Not supported** — no C# on macOS |
121
+ | `/excel/rearrange-overlaps` | **Not supported** |
122
+ | `/excel/hide-rows` | **Not supported** |
123
+ | `/excel/export-pdf`, `/excel/export-csv` | **Not supported** — for CSV, use a Node script (`scripting.md`) |
124
+ | `/excel/reorder-columns`, `/excel/delete-columns` | **Not supported** |
125
+ | `workbookId` parameter | **Ignored** — always use `filePath` |
126
+ | Chart types: 3D, doughnut, radar, bubble, surface, stock, smooth scatter, stacked line-markers | **Rejected with an error** — only the flat column/bar/line/pie/scatter/area family works (see `reference/api/advanced.md` Chart Types) |
127
+ | Chart axis titles | **Not settable** — only the chart `title`. Raw AppleScript attempts fail with -1723/-50; don't try them |
128
+ | Chart data WARNING validation | **Not performed** — verify with `read-range` before charting and `get-status` after |
129
+ | Pivot `dateGrouping` | **Rejected with an error** — group via a helper column (`=YEAR(A2)`) instead |
130
+ | Conditional formatting `colorScaleType: "TwoColor"` | **Ignored** — always a three-color scale |
131
+ | Conditional formatting `dataBarColor` | **Ignored** — default bar color |
132
+ | `format-range` batch mode: `underline`, `verticalAlignment`, `autoFit`, `mergeCells` | **Single-call only** (supported there), not in `formatting`/`batch` arrays |
133
+ | `/excel/undo` | **User actions only** — never reverts API changes (`write-range`, `write-formula`, formatting); the call returns success without reverting them. Revert API changes by writing the previous value back |
134
+
135
+ ---
136
+
137
+ ## macOS UIA: Color Picker
138
+
139
+ **CRITICAL:** On macOS, clicking Fill Color or Font Color opens a **SEPARATE Excel window**:
140
+
141
+ 1. Select cells in main workbook
142
+ 2. Click Fill Color dropdown arrow in ribbon
143
+ 3. Check AvailableApplicationWindows for new Excel window (title like "Font Color")
144
+ 4. **Switch to that color picker window** (AppAct with that window identifier)
145
+ 5. Use keyboard navigation: `[k(down)][k(right)][k(right)][k(right)][k(enter)]`
146
+ 6. Window auto-closes, color is applied
147
+
148
+ **Never try keyboard on main workbook when color picker is open** — it will navigate cells!
149
+
150
+ ---
151
+
152
+ ## macOS Issues
153
+
154
+ | Issue | Fix |
155
+ |-------|-----|
156
+ | "Excel not responding" | Ensure Excel is open |
157
+ | "No workbook is open" | Open or create a workbook first |
158
+ | Script timeout | Wait and retry |
159
+ | Permission denied | System Preferences → Security → Privacy → Terminal |
160
+ | API fails | Fall back to AppAct (UIA) |
161
+ | Color picker not responding | Switch to separate window, use keyboard nav |
@@ -0,0 +1,180 @@
1
+ ---
2
+ name: excel-architect
3
+ friendly_name: Excel Architect
4
+ version: 1.0.0
5
+ description: Excel and spreadsheet tasks (.xlsx, .xls, .csv). ALWAYS activate for ANY spreadsheet work, including simple ones such as extracting or filtering rows/columns to CSV, converting xlsx to csv, reading or editing cell data, building dashboards or models, and formatting. Trigger whenever a request mentions Excel, a spreadsheet, a workbook, or an .xlsx/.csv file. Routes to Generator, Live Excel API, or Node scripting by context cost.
6
+ icon: excel
7
+ color: 217346
8
+ ---
9
+
10
+ # Excel Architect
11
+
12
+ ## Read once, build once
13
+
14
+ - **Cache rule.** Skill files already attached are in context. Do NOT ReadFile them again. `/loop` ticks and `continue` may re-attach the same file — treat as duplicate, advance to the next phase.
15
+ - **Re-read = loop signal.** "Let me re-read the schema/archetype/generator" → you are looping. Take the next concrete action (build spec, call endpoint, fix error).
16
+ - **No JSON in `<thinking>`.** Plan in prose (sheets, key addresses, formula shapes). JSON only inside the script you write or the actual tool-call body. Drafting JSON in reasoning burns the output budget.
17
+ - **Large workbooks → `bodyFromFile`.** If ≥ 5 sheets OR any sheet has ≥ 50 rows: put the spec JSON on disk, call with the path. ExecuteSkillApi hydrates `bodyFromFile` server-side — do NOT `ReadFile` it back. NEVER substitute a Live-Excel `/excel/*` write loop. Endpoint, payload shape, and concrete example are in the platform section below (macOS → Generator; Windows → composite endpoints).
18
+
19
+ **The `bodyFromFile` path MUST be under the OS temp dir** — Windows `%TEMP%\...` (= `C:\Users\<user>\AppData\Local\Temp\...`), macOS/Linux `/tmp/...`. NEVER write the spec to Documents, Desktop, Downloads, or any other user folder. (`outputPath`/`filePath` and other user-facing files DO go to user folders — this rule is only for the internal `bodyFromFile` spec.) The executor auto-deletes temp spec files after a successful call; files outside temp linger forever and clutter the user's machine.
20
+
21
+ **Use a unique filename per run.** Suffix with a timestamp or short tag — e.g. `/tmp/workbook-1714838400.json`, `C:\Users\<user>\AppData\Local\Temp\workbook-1714838400.json`, `/tmp/build-workbook-1714838400.js`. Resolve environment variables before passing `bodyFromFile`; never pass `%TEMP%` literally. Reusing the same name (`workbook.json`, `build-workbook.js`) collides with leftover files from previous runs.
22
+
23
+ **Never expose internal terminology to the user — anywhere in chat, ever.** Forbidden list: `bodyFromFile`, `JSON`, `Node script`, `script`, `spec`, `payload`, `temp file`, `inline body`, `WriteFile`, `ReadFile`, `ExecuteSkillApi`, `endpoint`, `staging`, `payload limits`, `NODE_PATH`, `node_modules`, `npm install`, package names (`xlsx`, `exceljs`) unless the user explicitly asks about implementation. The user asked for a workbook; they don't need to know HOW it gets built. **Never ask the user to choose between implementation paths** ("should I draft a script?", "do you want bodyFromFile?") — you decide silently. **Never narrate reading this skill or checking dependencies.** The only acceptable user-facing progress is one short plain-language status update: *"Setting up your workbook."* / *"Building it now."* / *"Putting the sheets together."*
24
+
25
+ Two ways to produce the file — pick by shape:
26
+ 1. **Static** (long-but-flat, no loops): `WriteFile` the JSON straight to disk in the OS temp dir.
27
+ 2. **Repetitive/programmatic** (same row/cell shape repeats N times — N-year projections, N × M time-series grids, N × M pivots, generated formula columns, dated rows, schedules with N tasks, anything you'd write with a `for` loop): `WriteFile` a Node script that builds the spec and writes the JSON to disk via `fs.writeFileSync(<temp-path>, JSON.stringify(spec))`, then run it with your platform's command-execution tool — `ExecuteBashCommand` on macOS (`node build-workbook.js`), `ExecutePowershellCommand` on Windows (`node build-workbook.js`). Have the script write the file directly rather than redirecting stdout (`>` in PowerShell 5.1 writes UTF-16 BOM, which breaks JSON parsing). JS loops replace hundreds of lines of inline JSON.
28
+
29
+ To tweak one field (`outputPath`/`filePath`, `theme`) without rewriting: pass `bodyFromFile` + a small inline `body`; inline wins on collision.
30
+
31
+ Simple Table / single-sheet edits → build inline; file overhead not worth it.
32
+
33
+ ---
34
+
35
+ ## Excel stays off screen
36
+
37
+ **The user asked for a workbook, not for Excel.** Creating, editing, formatting, charting and verifying all happen without Excel appearing, and you must keep it that way. A window that opens on its own steals focus, covers what the user is doing, and invites them to edit a workbook you are still writing.
38
+
39
+ Creating was already silent. **On Windows, `open-or-attach-workbook` now also defaults to leaving Excel off screen** — you do not have to ask for this, only avoid breaking it.
40
+
41
+ **Pass `"visible": true` only when the user asked to see the workbook**, in words like "open it", "show me", "let me look at it", or "leave it open when you're done". A request to *build*, *fill in* or *fix* a workbook is not a request to watch it happen.
42
+
43
+ The `/excel/*` API does not need a window. Writes, reads, formulas, formatting, freeze panes, auto-fit, **charts**, `get-status` and save were each measured working with Excel hidden; sort and filter run hidden in CI; and the generator path has been silent all along.
44
+
45
+ | Operation | Needs Excel on screen? |
46
+ |-----------|------------------------|
47
+ | Data, formulas, formatting, freeze panes, auto-fit, charts, health, save | **No** — measured |
48
+ | Sort / filter | **No** — covered hidden by the end-to-end tests |
49
+ | Generator / `build-workbook` | **No** — already silent |
50
+ | Pivots, and anything else not listed | **Expected no**, not yet measured — the API is the same object model, so treat a window as unnecessary and report it if you see otherwise |
51
+ | `export-csv` | May briefly flash a window: it builds a temporary workbook internally |
52
+ | Computer use on Excel (screenshots, clicking, UIA/AppAct) | **Yes** — pass `"visible": true` first |
53
+ | The user explicitly asking to see or keep the workbook open | **Yes** — that is what the flag is for |
54
+
55
+ **One consequence worth knowing:** a workbook the user already has on screen stays there. `"visible": false` means "do not reveal", never "conceal" — one Excel process hosts every workbook in a shared window set, so hiding could take the user's own work off screen, and the API deliberately will not do that.
56
+
57
+ **macOS:** there is no `visible` flag; it is ignored. The macOS scripts already avoid raising the Excel window when they attach, but do not promise the user that Excel will stay hidden on a Mac — say nothing about it either way.
58
+
59
+ ---
60
+
61
+ ## Release the file when you're done
62
+
63
+ **An open workbook stays locked.** The user who opens the file you just saved gets "already used by another process", or read-only if they force it.
64
+
65
+ End a task with `/excel/close-workbook` when you opened or created the workbook yourself:
66
+
67
+ - **Last** — after the final `save-workbook` and after any `get-status` check. A confirmed close drops the id and nothing reopens it, so close only once every write, formatting and chart step is done.
68
+ - **Name the workbook explicitly.** Windows: the `workbookId` you hold. macOS: the exact `filePath` — `workbookId` is ignored there, and a close with neither closes whatever workbook is active and saves it.
69
+ - **Skip it when the workbook was already open before you attached.** You did not open it, so do not close it — `saveBeforeClose` defaults to true, so closing it would also save edits the user never reviewed.
70
+ - Skip it when the user asked to see the workbook or keep it open — then leaving it open is the point.
71
+
72
+ On Windows the workbook is off screen, so a lock you leave behind is invisible: there is no window for the user to spot and close.
73
+
74
+ ---
75
+
76
+ ## Step 1: Route the task
77
+
78
+ Three paths. Pick one before loading anything heavy.
79
+
80
+ **Discover first (existing file).** `open-or-attach-workbook` (or `get-workbook-info`) returns the actual sheet names. Some discovery responses also include a `recommended` block (row/col counts, sample ranges); use it when present. If `recommended` is missing, call `get-sheet-dimensions` after you know the real sheet name. **Never route without a measured size, never probe with `read-range`, never assume the sheet is `"Sheet1"`.** Do not batch `get-sheet-dimensions` with the discovery call that reveals the sheet names. Route on the measured size.
81
+
82
+ **Deciding question: would the operations to accomplish the goal pull a lot of data into context?**
83
+
84
+ - **Script path** — YES only when the workbook is a saved local file: the goal needs to read/inspect/transform many rows (extract range/column → CSV/JSON, filter-by-content, dedupe, per-row logic). Run a Node script, file→file; rows never enter context. If the workbook is open with unsaved changes, first save or Save As to a local temp copy. If Excel reports a SharePoint/OneDrive/browser URL or no local path, do not script against that URL; save/export to a local copy first or stay on the `/excel/*` API path. → load `scripting.md` + `reference/api/basic.md`. This is the rule for any large or context-bloating operation.
85
+ - **Edit path** — NO: targeted or templated changes to an existing file (fill a formula column, format/sort/filter a range, add charts/pivots). Templated bulk ops return no data → prefer the API even on a huge doc (`write-formulas-batch` fills a 60k-row column in one call). → load `building.md`.
86
+ - **Create path** — new workbook from scratch. → load `create.md`, then `building.md`.
87
+
88
+ **Key rules:**
89
+ - Plan before building. Skipping causes cascading formula errors.
90
+ - Don't expose internals — no endpoint names or JSON in user-facing messages.
91
+ - For large extraction/transform tasks, do not echo headers, sample rows, dependency checks, temp paths, tool names, or package names in chat. The final answer should contain only user-facing output paths, row/file counts, and any user-relevant caveat.
92
+ - Don't invent data on CREATE — WebSearch for real numbers.
93
+
94
+ ---
95
+
96
+ ## Phase 0: Load References
97
+
98
+ Load by path. Already-attached files are not re-read. **Paths are relative to this skill folder (where SKILL.md lives). Bare filenames (`scripting.md`, `building.md`, `create.md`, `generator.md`) are at the skill root — do NOT prepend `reference/` or `windows/`.**
99
+
100
+ | Path | Load |
101
+ |------|------|
102
+ | **Script** | `scripting.md`, `reference/api/basic.md` for workbook discovery only (Node; NOT `windows/api/scripting.md`, which is C#) |
103
+ | **Edit** | `building.md`, `reference/api/basic.md` |
104
+ | **Create** | `create.md`, `building.md`, `reference/api/basic.md`; macOS → `generator.md` + chosen archetype; Windows → `windows/api/composites.md` |
105
+
106
+ `reference/api/basic.md` covers workbook/sheet/data ops, formulas, formatting (`format-range`, `auto-fit-columns`, `freeze-panes`), analysis (`sort-range`, `filter-range`), health-check — needed for every API/Generator op.
107
+
108
+ **On-demand (load when triggered):**
109
+
110
+ | Trigger | File |
111
+ |---------|------|
112
+ | Financial Model JSON skeletons | `archetypes/01-financial-model-advanced.md` |
113
+ | Styling, colors | `reference/guides.md` |
114
+ | Charts, pivots, conditional formatting, data validation, hide rows, merge cells | `reference/api/advanced.md` |
115
+ | Repairing errors | `reference/repair.md` |
116
+ | Full troubleshooting | `reference/troubleshooting.md` |
117
+ | `paste_content` HTML bulk entry, formula safety checklist | `data-and-formulas.md` |
118
+ | Number formats, Big Four style guide, UIA formatting workflows | `styling-and-features.md` |
119
+
120
+ ---
121
+
122
+ ## Loop prevention
123
+
124
+ On any hit: stop and report. Do not "try one more fix".
125
+
126
+ - API calls > 50 (CREATE) / > 30 (EDIT) → stop.
127
+ - Same cell errors twice → skip the cell.
128
+ - Same endpoint + same params twice → rethink, don't repeat.
129
+ - "file busy" / "already used by another process" → don't retry. `/excel/list-open-workbooks` → `/excel/close-workbook` → retry once.
130
+ - Phase 5 repair actions > 10 → stop.
131
+ - Formula error recurs after a fix → root cause is upstream (empty source). Fix the source, not the symptom.
132
+ - Re-reading an already-attached skill file → loop signal, advance phase.
133
+
134
+ ## Important: Resolving `<skill-path>`
135
+
136
+ Throughout this documentation, `<skill-path>` refers to **this skill's folder**:
137
+ - This skill's location is the path to this SKILL.md file
138
+ - Remove the filename (SKILL.md) to get the skill folder
139
+ - Example: If location is `/path/to/excel-architect/SKILL.md`, then `<skill-path>` = `/path/to/excel-architect`
140
+
141
+ ---
142
+
143
+ ## Core Principles — Generator vs Live Excel vs Script
144
+
145
+ | Approach | When to Use | Platform |
146
+ |----------|-------------|----------|
147
+ | **Generator** (`/excel-gen/generate`) | New workbooks from scratch: reports, dashboards, data exports, financial models | **macOS only** |
148
+ | **Live Excel** (`/excel/*`) | Editing existing workbooks, templated bulk ops (formula fills, format/sort/filter), charts, pivots, creating workbooks on Windows | All platforms |
149
+ | **Node Script** (`scripting.md`) | Operations that would pull a lot of data into context: bulk read/extract, content-dependent transforms | All platforms |
150
+
151
+ > Endpoint, body schema, and JSON examples for new-workbook creation live in `generator.md` (macOS Generator) and `windows/api/composites.md` (`build-workbook`/`build-sheet`). **Don't cross schemas:** the Generator uses `options.outputPath`; build-workbook uses `filePath` at root. Use only the schema from your platform's section.
152
+
153
+ **macOS: ALWAYS pass the exact `filePath` to every `/excel/*` call that targets a workbook.** After `/excel/open-or-attach-workbook` or `/excel/create-workbook` returns, reuse that exact `filePath` in all subsequent calls. Do NOT omit it, guess it, reconstruct it, or rely on the active workbook: macOS rejects a target-bearing call with no `filePath`, and the user can refocus Excel at any moment. If you don't have the path, call `/excel/list-open-workbooks` or `file_discovery` first. (Windows resolves the workbook differently and does not require this.)
154
+
155
+ ---
156
+
157
+ ## Endpoint Index
158
+
159
+ All `/excel/` endpoints — read `reference/api/basic.md` (data/formulas) or `reference/api/advanced.md` (charts/formatting) for parameters.
160
+
161
+ **Composite (Win):** build-workbook, build-sheet (`windows/api/composites.md`) | **Workbook:** list-open-workbooks, open-or-attach-workbook, create-workbook, get-workbook-info, save-workbook, close-workbook | **Sheets:** select-sheet, create-sheets (Mac), delete-sheet, rename-sheet, get-sheet-dimensions | **Data:** read-range, write-range, write-ranges-batch (Win), append-rows, clear-range, copy-paste, find-replace, reorder-columns (Win), delete-columns (Win) | **Formulas:** write-formula, write-formulas-batch | **Format:** format-range, auto-fit-columns, freeze-panes, conditional-formatting, add-data-validation, merge-cells, hide-rows (Win) | **Charts:** add-chart-from-range, delete-chart | **Analysis:** sort-range, filter-range, create-pivot-table | **Health:** get-status | **Undo:** undo | **Export:** export-pdf (Win), export-csv (Win)
162
+
163
+ **Close behavior:** Omitting `saveBeforeClose` saves the workbook on both Windows and macOS. Pass explicit `saveBeforeClose: true` or `saveBeforeClose: false` whenever persistence intent matters: `true` saves before closing; `false` discards unsaved changes.
164
+
165
+ ---
166
+
167
+ ## Troubleshooting
168
+
169
+ | Issue | Solution |
170
+ |-------|----------|
171
+ | **"file is already used by another process"** / **"Excel appears busy"** | **STOP. Do NOT retry the same call.** Run `/excel/list-open-workbooks`. If the file is open → `/excel/close-workbook`. If a DIFFERENT file is open → close it too or use a different filename. Then retry ONCE. |
172
+ | Range timeout | Use specific range, not `A:A` |
173
+ | `read-range` returns fewer cells than requested | Read failed — never "those cells are empty". Re-read raw: drop `useFormattedText` / `returnFormulas`. **Never infer or invent the values, never report them as read.** Still short → say so and stop. |
174
+ | `#REF!` / `#NAME?` | Sheet name mismatch or missing quotes — run `get-workbook-info` |
175
+ | Chart appears empty | Source data missing — write formulas first, then chart |
176
+ | Dashboard shows $0 / wrong values | Cross-sheet ref target is empty — verify with `read-range` |
177
+ | Agent loops on same error | Respect stop conditions: max 3 per cell, max 10 total |
178
+ | Any error repeating 2+ times | **STOP retrying.** The approach is wrong. Try: different filename, close Excel, or ask the user. |
179
+
180
+ For the complete troubleshooting table (38 issues), read `reference/troubleshooting.md`.
@@ -0,0 +1,61 @@
1
+ # Excel Architect — Windows
2
+
3
+ Windows-only features. Shared rules and workflow phases are in the main skill file and `building.md`.
4
+
5
+ ## Composite endpoints — MANDATORY for new workbooks
6
+
7
+ New workbook/sheet → `build-workbook` or `build-sheet` (replaces 60+ individual calls: data, formulas, formatting, conditional formatting, charts, freeze, auto-fit, health check, save). **Load `windows/api/composites.md`** for the full schema, minimal example, common mistakes, build strategy, header-name formulas, label-based cross-sheet refs, and the completeness checklist.
8
+
9
+ **Large payloads → `bodyFromFile`** (absolute temp path) when a sheet has ≥ 50 rows OR the workbook has ≥ 5 sheets. See SKILL.md "Read once, build once" for the recipe.
10
+
11
+ ```json
12
+ { "operations": [{ "endpoint": "/excel/build-workbook", "bodyFromFile": "C:\\Users\\me\\AppData\\Local\\Temp\\workbook-<tag>.json" }],
13
+ "toolName": "Build Workbook", "description": "..." }
14
+ ```
15
+
16
+ Resolve `%TEMP%` before constructing the JSON; do not pass `%TEMP%` literally.
17
+
18
+ **⚠️ `build-workbook` returns `success: true` even when formulas fail silently.** Check ALL THREE error channels: `formulaErrors`, `sheetResults[].error` (structural per-sheet failures), `warnings`. If any is non-empty, fix and rebuild. Schema in `windows/api/composites.md` §Response Fields.
19
+
20
+ ---
21
+
22
+ ## Other Windows-Only Endpoints
23
+
24
+ | Endpoint | Purpose |
25
+ |----------|---------|
26
+ | `/excel/write-ranges-batch` | Write to multiple non-contiguous ranges in one call |
27
+ | `/excel/reorder-columns` | Rearrange column order |
28
+ | `/excel/delete-columns` | Delete whole columns (`"J"`, `"J:K"`, `"B,D,F"`). Use this — do NOT click Excel UI. |
29
+ | `/excel/execute-script` | Run C# scripts (LAST RESORT) |
30
+ | `/excel/export-pdf` | Export workbook or sheet to PDF |
31
+ | `/excel/export-csv` | Export sheet to CSV |
32
+ | `/excel/delete-chart` | Delete one or all charts on a sheet |
33
+ | `/excel/rearrange-overlaps` | Fix overlapping charts |
34
+
35
+ Parameters: `reference/api/basic.md` (write-ranges-batch, reorder-columns, export-pdf, export-csv, format/sort/filter) and `reference/api/advanced.md` (charts).
36
+
37
+ ---
38
+
39
+ ## ExecuteSkillApi Batch Mode
40
+
41
+ Combine independent calls in one tool call: `{ "operations": [{ "endpoint": "/excel/write-range", "body": {...} }, { "endpoint": "/excel/save-workbook", "body": {} }] }`. Use when steps don't depend on the previous result.
42
+
43
+ **🚨 NEVER batch `/excel/write-formula` with `/excel/write-formulas-batch` in the same `operations[]`.** Excel COM serializes formula calls; the second fails with a COM memory error. Send them as separate tool calls. Other endpoints batch fine — this is formula-write-specific.
44
+
45
+ ---
46
+
47
+ ## C# Scripts: LAST RESORT
48
+
49
+ `/excel/execute-script` is unreliable — COM interop is fragile (`Marshal.ReleaseComObject` required, wrong threading = silent hangs). Check API endpoints first (`reference/api/basic.md`, `reference/api/advanced.md`); most operations are supported. Only fall back to C# if the API can't do it, and **MUST READ `windows/api/scripting.md` first**.
50
+
51
+ ---
52
+
53
+ ## Windows-Only Documentation
54
+
55
+ | File | Content |
56
+ |------|---------|
57
+ | `windows/api/composites.md` | Full build-workbook/build-sheet schemas, build guidance, examples, chart types |
58
+ | `windows/api/scripting.md` | C# scripts (MUST READ before any script) |
59
+ | `windows/examples/level-1-workflows.md` | Basic workflows |
60
+ | `windows/examples/level-2-advanced.md` | Advanced operations |
61
+ | `windows/examples/level-3-scripting.md` | C# script patterns |