@uipath/delegate-sdk 1.203.1 → 1.203.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +729 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +444 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +224 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,348 @@
1
+ # Excel Architect — Reference Guide
2
+
3
+ Detailed styling, formatting, and workflow guidance. Load this file when you need paste_content, Big Four styling, pivot tables, keyboard shortcuts, or step-by-step workflows.
4
+
5
+ **Contents:**
6
+ 1. paste_content (styled data entry)
7
+ 2. Professional styling presets (color coding + 3 visual themes)
8
+ 3. Number formatting (codes + rules)
9
+ 4. Multi-currency portfolios
10
+ 5. Keyboard shortcuts
11
+ 6. Complete workflows (5-phase aligned)
12
+
13
+ ---
14
+
15
+ ## 1. paste_content — Styled Data Entry
16
+
17
+ **Use ONLY when you need inline text styling (bold, font colors).** For plain data + formulas, use the API instead.
18
+
19
+ ### When to Use
20
+ - Inline styling (bold headers, colored inputs) in one HTML blob
21
+ - Live formulas — `=SUM(B2:C2)` pastes as a real Excel formula
22
+
23
+ ### When NOT to Use
24
+ - Plain data without styling → use `write-range` (faster, no UIA needed)
25
+ - paste_content requires clicking a cell first via UIA — adds failure risk
26
+
27
+ ### Example
28
+ ```json
29
+ {
30
+ "type": "paste_content",
31
+ "payload": {
32
+ "content": "<table><tr><th style=\"font-weight:bold;\">Dept</th><th style=\"font-weight:bold;\">Q1</th><th style=\"font-weight:bold;\">Total</th></tr><tr><td>Sales</td><td style=\"color:#0000FF;\">100</td><td>=SUM(B2:B2)</td></tr></table>",
33
+ "contentType": "html",
34
+ "fontFamily": "Aptos"
35
+ }
36
+ }
37
+ ```
38
+
39
+ ### What Works / What Doesn't
40
+ | Style | Supported | How |
41
+ |-------|-----------|-----|
42
+ | Font color | Yes | `style="color:#0000FF;"` |
43
+ | Bold/Italic | Yes | `style="font-weight:bold;"` or `<b>` |
44
+ | Formulas | Yes | Write `=SUM(B2:C2)` as cell text |
45
+ | Background | No | Apply after via API |
46
+ | Borders | No | Apply after via API |
47
+
48
+ ### Workflow
49
+ 1. Select sheet → navigate to A1
50
+ 2. paste_content with full HTML table (ONE call)
51
+ 3. Apply background colors, borders, number formats via API
52
+ 4. Auto-fit columns (MANDATORY last step)
53
+
54
+ **Font:** `"Aptos"` for Office 2024+, `"Calibri"` for earlier.
55
+
56
+ ---
57
+
58
+ ## 2. Professional Styling Presets
59
+
60
+ ### Financial Model Color Coding
61
+
62
+ Standard color conventions for financial models. Apply via font color (`fontColorHtml` in format-range):
63
+
64
+ | Font Color | Hex | Meaning |
65
+ |------------|-----|---------|
66
+ | Blue | #0000FF | Input / assumption (user-editable) |
67
+ | Black | #000000 | Formula / calculation |
68
+ | Green | #008000 | Cross-sheet reference |
69
+ | Red | #FF0000 | External link or hardcoded override |
70
+
71
+ Place assumptions in dedicated labeled cells (e.g., `Tax Rate` in B3) and reference them with absolute refs (`$B$3`).
72
+
73
+ ### Visual Themes
74
+
75
+ Pick the theme that best matches the user's context, or ask if unclear.
76
+
77
+ ### A. Big Four / McKinsey (default for financial models)
78
+
79
+ | Element | Style |
80
+ |---------|-------|
81
+ | Headers | #4472C4 bg, white bold, centered |
82
+ | Data | Alternating white / #F2F2F2, left-aligned |
83
+ | Numbers | Right-aligned, correct decimals |
84
+ | Currency | Accounting format with $ |
85
+ | Borders | Thin gray #D9D9D9, bottom border on headers |
86
+ | Fonts | Calibri 10-11pt data, 12pt headers |
87
+
88
+ **Palette:** `header` #4472C4 · `input` #FFFF99 · `output` #D9D9D9 · `accent` #BDD7EE · `error` #FFC7CE
89
+
90
+ ### B. Corporate / Executive (dashboards, board decks)
91
+
92
+ | Element | Style |
93
+ |---------|-------|
94
+ | Headers | #1F3864 bg (dark navy), white bold, centered |
95
+ | Data | White bg, left-aligned |
96
+ | KPI highlights | #E2EFDA bg (soft green) for positive, #FCE4EC bg (soft red) for negative |
97
+ | Borders | None or minimal hairline #BFBFBF |
98
+ | Fonts | Aptos 10pt data, 14pt section titles |
99
+
100
+ **Palette:** `header` #1F3864 · `accent` #2E75B6 · `positive` #E2EFDA · `negative` #FCE4EC · `neutral` #F2F2F2
101
+
102
+ ### C. Modern Minimal (data analysis, reports)
103
+
104
+ | Element | Style |
105
+ |---------|-------|
106
+ | Headers | No fill, bold black, bottom border #000000 (medium) |
107
+ | Data | White bg, left-aligned |
108
+ | Totals | Top border (thin), bold |
109
+ | Borders | Bottom border on headers only, no grid |
110
+ | Fonts | Aptos 10pt data, 11pt headers |
111
+
112
+ **Palette:** `header-border` #000000 · `subtotal-bg` #F7F7F7 · `accent` #5B9BD5 · `muted` #A6A6A6
113
+
114
+ ### Choosing a Preset
115
+ | User Context | Preset |
116
+ |--------------|--------|
117
+ | Financial model, valuation, budget | A (Big Four) |
118
+ | Executive dashboard, board report, KPI summary | B (Corporate) |
119
+ | Data analysis, simple report, general use | C (Modern Minimal) |
120
+ | User has existing file with formatting | Match existing — never override |
121
+
122
+ ### Sheet Organization
123
+ ```
124
+ Sheet 1: Cover/Summary Sheet 4: Outputs (Bold)
125
+ Sheet 2: Inputs (Blue font) Sheet 5: Charts
126
+ Sheet 3: Calculations (Black) Sheet 6: Raw Data
127
+ ```
128
+
129
+ ### Section Layout
130
+ ```
131
+ Row 1-2: Title (Bold, larger) Row 4: Headers (Bold, Dark Fill)
132
+ Row 3: Blank Row 5+: Data
133
+ Last: Totals (Bold, Top Border)
134
+ ```
135
+
136
+ ---
137
+
138
+ ## 3. Number Formatting
139
+
140
+ ### Format Codes
141
+
142
+ | Format | Code | Result |
143
+ |--------|------|--------|
144
+ | Currency | `$#,##0.00` | $1,234.56 |
145
+ | Percentage | `0.00%` | 12.34% |
146
+ | Accounting | `_($* #,##0.00_)` | $ 1,234.56 |
147
+ | Date | `mm/dd/yyyy` | 01/15/2024 |
148
+ | Date (Long) | `mmmm d, yyyy` | January 15, 2024 |
149
+ | Number | `#,##0` | 1,234 |
150
+ | Decimal | `0.00` | 1234.56 |
151
+
152
+ ### Formatting Rules
153
+
154
+ | Data Type | Rule | Example |
155
+ |-----------|------|---------|
156
+ | Years | Format as text or `0` — never `#,##0` | 2024 not 2,024 |
157
+ | Zero values | Show as dash `—` | `_($* #,##0_);_($* (#,##0);"-"` |
158
+ | Negatives | Parentheses, not minus sign | ($1,234) not -$1,234 |
159
+ | Percentages | One decimal: `0.0%` | 44.7% |
160
+ | Multiples | One decimal with x: `0.0"x"` | 2.5x |
161
+ | Currency | Accounting format for alignment | $ signs align in column |
162
+
163
+ ---
164
+
165
+ ## 4. Multi-Currency Portfolios
166
+
167
+ When a workbook mixes currencies (e.g., Chinese and American stocks), follow this structure:
168
+
169
+ ### Settings Sheet — Exchange Rates
170
+ ```
171
+ | Parameter | Value | Description |
172
+ | Exchange Rate CNY | 7.25 | Chinese Yuan per USD |
173
+ ```
174
+ Reference with `=Settings!$B$16` (absolute ref so it recalculates everywhere when updated).
175
+
176
+ ### Portfolio Sheet Layout
177
+ ```
178
+ | Stock | Shares | Price (Local) | Currency | Value (Local) | Value (USD) |
179
+ | AAPL | 50 | 180.00 | USD | =B2*C2 | =E2 |
180
+ | BABA | 100 | 85.00 | CNY | =B3*C3 | =E3/Settings!$B$16 |
181
+ ```
182
+
183
+ **Key rules:**
184
+ - **Separate header row from data** — never write data into the header row
185
+ - **Currency column** — explicit label so formulas can branch (`=IF(D2="CNY", E2/rate, E2)`)
186
+ - **All conversions via formula** — reference the Settings exchange rate, never hardcode `7.25` in formulas
187
+ - **Totals in USD only** — `=SUM(F2:F20)` on the converted column, not the local-currency column
188
+
189
+ ---
190
+
191
+ ## 5. Keyboard Shortcuts
192
+
193
+ ### Navigation
194
+ | Action | macOS | Windows |
195
+ |--------|-------|---------|
196
+ | Go to A1 | Cmd+Home | Ctrl+Home |
197
+ | Go to last cell | Cmd+End | Ctrl+End |
198
+ | Jump to edge | Cmd+Arrow | Ctrl+Arrow |
199
+ | Go to cell | Name Box → type → Enter | Same |
200
+ | Switch sheets | Ctrl+PageUp/Down | Ctrl+PageUp/Down |
201
+
202
+ ### Editing
203
+ | Action | macOS | Windows |
204
+ |--------|-------|---------|
205
+ | Edit cell | F2 | F2 |
206
+ | New line | Option+Enter | Alt+Enter |
207
+ | AutoSum | Cmd+Shift+T | Alt+= |
208
+ | Fill down/right | Cmd+D / Cmd+R | Ctrl+D / Ctrl+R |
209
+ | Toggle $ref | F4 | F4 |
210
+
211
+ ### Formatting
212
+ | Action | macOS | Windows |
213
+ |--------|-------|---------|
214
+ | Format Cells | Cmd+1 | Ctrl+1 |
215
+ | Bold | Cmd+B | Ctrl+B |
216
+ | Currency | Ctrl+Shift+$ | Ctrl+Shift+$ |
217
+ | Percentage | Ctrl+Shift+% | Ctrl+Shift+% |
218
+ | Create table | Cmd+T | Ctrl+T |
219
+
220
+ ---
221
+
222
+ ## 6. Complete Workflows
223
+
224
+ These workflows follow the 5-phase structure from SKILL.md.
225
+
226
+ ### Dashboard Workflow
227
+ ```
228
+ Phase 2: Open & Discover
229
+ - open-or-attach-workbook (standalone call)
230
+ - get-sheet-dimensions → read headers
231
+
232
+ Phase 3: Write Data
233
+ - write-range: headers, static data, and isolated formulas (ONE call per sheet)
234
+ - write-formulas-batch: formula columns and any repeating formulas across rows
235
+
236
+ Phase 4: Format & Enhance
237
+ - format-range batch: header style, borders, number formats
238
+ - freeze-panes (row 1)
239
+ - Conditional formatting / charts (if needed)
240
+
241
+ Phase 5: Finalize
242
+ - auto-fit-columns (AFTER all formatting)
243
+ - get-status (health check — fix any errors)
244
+ - save-workbook
245
+ ```
246
+
247
+ ### API vs UIA Split
248
+ ```
249
+ API (90%): write-range, write-formulas-batch, format-range, auto-fit, charts, formulas, conditional formatting
250
+ UIA (10%): Ribbon features, color picker, complex dialogs, screenshot verification
251
+ ```
252
+
253
+ ### Chart Examples
254
+
255
+ **Column chart (multi-series):**
256
+ ```json
257
+ {
258
+ "endpoint": "/excel/add-chart-from-range",
259
+ "body": {
260
+ "sheetName": "Dashboard",
261
+ "valueRange": "B2:D5",
262
+ "xLabelRange": "A2:A5",
263
+ "chartType": "column",
264
+ "title": "Q4 Sales by Region"
265
+ }
266
+ }
267
+ ```
268
+
269
+ **Pie chart (SINGLE column only):**
270
+ ```json
271
+ {
272
+ "endpoint": "/excel/add-chart-from-range",
273
+ "body": {
274
+ "sheetName": "Dashboard",
275
+ "sourceSheetName": "Portfolio",
276
+ "valueRange": "F2:F5",
277
+ "xLabelRange": "A2:A5",
278
+ "chartType": "pie",
279
+ "title": "Portfolio Allocation"
280
+ }
281
+ }
282
+ ```
283
+ ⚠️ Pie charts display only one series — `valueRange` must be a single column (e.g., `F2:F5`), not multi-column.
284
+
285
+ Always include `xLabelRange` — without it, charts show "1, 2, 3, 4".
286
+
287
+ ---
288
+
289
+ ## 7. Cross-Sheet Formula Syntax
290
+
291
+ **ALWAYS use cross-sheet formulas over static values.** Write `=Data!B2`, not the number.
292
+
293
+ **CRITICAL: If a sheet name contains spaces, you MUST wrap it in single quotes.** Missing quotes → `#NAME?` error.
294
+
295
+ | Reference | Syntax |
296
+ |-----------|--------|
297
+ | No spaces | `=Data!B5` |
298
+ | **Has spaces** | `='US Stocks'!B5` (**single quotes required**) |
299
+ | Range (spaces) | `=SUM('Sales Data'!B2:B100)` |
300
+ | VLOOKUP (spaces) | `=VLOOKUP(A2,'US Stocks'!$A$1:$B$100,2,FALSE)` |
301
+ | SUMIF (spaces) | `=SUMIF('Sales Data'!$A$1:$A$100,A2,'Sales Data'!$B$1:$B$100)` |
302
+ | No spaces | `=SUMIF(Data!$A$1:$A$100,A2,Data!$B$1:$B$100)` |
303
+
304
+ ---
305
+
306
+ ## 8. Formula Templates
307
+
308
+ Use `{row}` placeholder in `write-formula` and `write-formulas-batch`; for formula columns, prefer `write-formulas-batch` with `recommended.fillStartRow` and `recommended.fillRowCount`:
309
+ ```
310
+ =SUM(B{row}:D{row}) → =SUM(B2:D2), =SUM(B3:D3), ...
311
+ =D{row}/B{row}*100
312
+ =IF(E{row}>1000,"High","Low")
313
+ ```
314
+ Use `{row}` not `${row}`. Escape quotes: `\"High\"`.
315
+
316
+ ---
317
+
318
+ ## 9. Data Hygiene — Preventing #VALUE! Errors
319
+
320
+ **NEVER include currency symbols, percent signs, or other text in numeric data values.** This is the #1 cause of `#VALUE!` errors.
321
+
322
+ | WRONG (text — causes #VALUE!) | CORRECT (number + format) |
323
+ |-------------------------------|---------------------------|
324
+ | `"$120.50"` | `120.50` with `numberFormat: "$#,##0.00"` |
325
+ | `"15%"` | `0.15` with `numberFormat: "0.0%"` |
326
+ | `"¥725.00"` | `725.00` with `numberFormat: "¥#,##0.00"` |
327
+ | `"1,000"` | `1000` with `numberFormat: "#,##0"` |
328
+
329
+ All display formatting goes in the `formatting` array or `numberFormat`, never in data values.
330
+
331
+ ---
332
+
333
+ ## 10. Prevent write-range Spillover
334
+
335
+ Each `write-range` call writes data starting at the specified range. Multiple writes to overlapping areas leave old data in uncovered rows.
336
+
337
+ **Example:**
338
+ ```
339
+ Call 1: write-range to A1 with 25 rows → writes A1:A25
340
+ Call 2: write-range to A1 with 20 rows → writes A1:A20
341
+ Result: Rows 21-25 still contain OLD data — orphan rows!
342
+ ```
343
+
344
+ **Rules:**
345
+ 1. **Write each range ONCE.** Plan data arrays completely before writing.
346
+ 2. **If you must overwrite:** Clear the range first with `clear-range`, then write.
347
+ 3. **Never write formulas to rows beyond your data.** If data has 15 rows (2-16), don't write formulas to rows 17-20.
348
+ 4. **After correction writes:** Read back the full area (including rows BELOW) to confirm no orphan data.
@@ -0,0 +1,174 @@
1
+ # Repair & Recovery Reference
2
+
3
+ Detailed diagnosis, repair procedures, and recovery strategies for Excel workbook issues.
4
+ Load this file when Phase 5 (Verify & Repair) encounters errors that need deeper diagnosis.
5
+
6
+ **Contents:**
7
+ 1. [Formula Error Diagnosis Tree](#formula-error-diagnosis-tree)
8
+ 2. [Chart Repair Procedures](#chart-repair-procedures)
9
+ 3. [Anti-Patterns](#anti-patterns)
10
+ 4. [Write Verification Rules](#write-verification-rules)
11
+ 5. [COM Error Recovery (Windows)](#com-error-recovery-windows)
12
+ 6. [build-sheet Fallback (Windows)](#build-sheet-fallback-windows)
13
+
14
+ ---
15
+
16
+ ## Formula Error Diagnosis Tree
17
+
18
+ | Error Type | Common Cause | Fix |
19
+ |-----------|--------------|-----|
20
+ | `#REF!` | Referenced sheet/cell deleted or renamed. Sheet name in formula doesn't match actual name | `get-workbook-info` → compare names → rewrite formula |
21
+ | `#NAME?` | Sheet name with spaces missing single quotes (`=US Stocks!B5` instead of `='US Stocks'!B5`). Or typo in function name | Add single quotes. Check function spelling |
22
+ | `#VALUE!` | Formula references text instead of numbers. Data has currency symbols (`"$120"` instead of `120`) | Fix data: remove text formatting, use numbers + numberFormat |
23
+ | `#DIV/0!` | Denominator empty or zero. Total row wasn't written (silent `write-range` failure) | Check denominator cell. If empty, write missing data. Wrap with `=IFERROR(formula, 0)` |
24
+ | `#N/A` | VLOOKUP/MATCH can't find value. Lookup key has extra spaces or different case | Check lookup key formatting. Use `IFERROR` wrapper |
25
+ | `#NULL!` | Missing range operator (colon or comma) in formula | Fix formula syntax |
26
+ | `#NUM!` | Number too large/small or invalid math operation | Check formula logic |
27
+ | Cell empty | `write-range` silently failed; data never arrived. Common with total/summary rows | Read cell to confirm empty, then re-write |
28
+
29
+ ### Diagnosis Procedure (per cell)
30
+
31
+ ```
32
+ 1. READ the broken cell with returnFormulas: true
33
+ → What formula is there? What is it trying to do?
34
+
35
+ 2. IDENTIFY the references in the formula
36
+ → Cross-sheet? Which sheet? Which cell?
37
+
38
+ 3. READ each referenced cell
39
+ → Is the source cell empty? Wrong value? Wrong row?
40
+
41
+ 4. COMPARE with your Phase 2 plan
42
+ → Does the formula point to where you planned the data?
43
+
44
+ 5. FIX the specific root cause:
45
+ - Wrong row number → read source sheet, find correct row
46
+ - Wrong sheet name → use names from get-workbook-info
47
+ - Missing data → write the data first, then formula auto-resolves
48
+ - Text in numeric field → rewrite data as numbers + formatting
49
+
50
+ 6. VERIFY: read-range (returnFormulas: false)
51
+ → Does it show the expected value now?
52
+ ```
53
+
54
+ ---
55
+
56
+ ## Chart Repair Procedures
57
+
58
+ ```
59
+ 1. READ the chart's expected source range (valueRange)
60
+ → Are cells populated with numbers (not zeros, not empty, not #REF!)?
61
+
62
+ 2. If source data MISSING:
63
+ → Write the missing formulas/data first
64
+ → Chart should auto-update — re-check
65
+
66
+ 3. If source data EXISTS but chart still empty:
67
+ → delete-chart → recreate with correct parameters
68
+ → Common cause: chart was created BEFORE formulas were written
69
+
70
+ 4. If all-zero values:
71
+ → Fix the formulas (the data problem, not the chart)
72
+ → Chart auto-updates when data is fixed
73
+
74
+ 5. If pie/doughnut with wrong data:
75
+ → delete-chart → recreate with SINGLE-column valueRange
76
+ → See reference/api/advanced.md §Pie & Doughnut Charts
77
+ ```
78
+
79
+ **Limits:** Max 2 recreation attempts per chart. If still broken, STOP and report.
80
+
81
+ ---
82
+
83
+ ## Anti-Patterns
84
+
85
+ **NEVER do any of these during repair:**
86
+
87
+ | Anti-Pattern | Why It's Wrong | Do This Instead |
88
+ |-------------|---------------|-----------------|
89
+ | Rewrite formula without reading first | You don't know what's wrong | `read-range` with `returnFormulas: true` first |
90
+ | Guess the correct row number | You WILL guess wrong after edits shift rows | Read the source sheet to find the actual row |
91
+ | Replace formula with hardcoded number | Breaks dynamic recalculation | Fix the formula to reference the correct cell |
92
+ | Write multiple fixes without verifying | Fixes can interact and cascade | Verify each fix before the next |
93
+ | Overwrite raw data with formulas | Destroys source data, may create circular refs | Computed columns go AFTER all data columns |
94
+ | Fix symptoms instead of root causes | Same error will recur or cascade | Follow diagnosis tree to find actual root cause |
95
+ | Call same endpoint with same params repeatedly | You're in a loop — the approach is wrong | STOP, rethink, try a different fix strategy |
96
+
97
+ ---
98
+
99
+ ## Write Verification Rules
100
+
101
+ ### After write-range
102
+
103
+ `write-range` may return HTTP 200 but silently write zero rows. This happens frequently with total/summary rows appended beyond the main data block.
104
+
105
+ **After ANY write-range that writes static totals or isolated formulas:**
106
+ 1. Call `read-range` on 1–2 cells you just wrote
107
+ 2. If empty → the write silently failed → retry
108
+ 3. Common cause: writing to rows beyond the used range
109
+
110
+ For repeated formula columns, use `write-formulas-batch` with `recommended.fillStartRow` and `recommended.fillRowCount`, then spot-check `recommended.spotVerifyRows` with `returnFormulas:true`.
111
+
112
+ ### Dashboard References
113
+
114
+ Before writing ANY cross-sheet formula on a Dashboard sheet:
115
+ 1. `read-range` the target cell (e.g., `Portfolio!I19`) → confirm it has the expected value
116
+ 2. If empty or 0 → the target row is missing → write it first, verify again
117
+ 3. Only THEN write the Dashboard formula
118
+
119
+ **Never blindly write `='Portfolio'!I19` without confirming I19 exists.** Silent write failures cascade: empty total → 0% weights → $0 on Dashboard → #DIV/0! in ratios.
120
+
121
+ ### Raw Data Protection
122
+
123
+ When a sheet has monthly/periodic data (e.g., Jan–Jun in columns C–H), those columns contain **source values**. NEVER replace a data cell with a formula. Totals, averages, and percentages go in **separate columns after the data**.
124
+
125
+ **Wrong:** Overwriting C2 (Jan Salary = 8500) with a formula — destroys raw value AND may create circular reference.
126
+ **Correct:** Leave C2 = 8500. Put `=SUM(C2:H2)` in I2 and `=AVERAGE(C2:H2)` in J2.
127
+
128
+ ### Prevent write-range Spillover
129
+
130
+ Each `write-range` writes data starting at the specified range. Multiple writes to overlapping areas leave old data in rows the second call doesn't cover.
131
+
132
+ **Rules:**
133
+ 1. **Write each range ONCE.** Plan data arrays completely before writing.
134
+ 2. **If you must overwrite:** Clear the range first with `clear-range`, then write.
135
+ 3. **Never write formulas to rows beyond your data.** If data has 15 rows, don't write formulas to row 20.
136
+ 4. **After correction writes:** Read back the full area (including rows BELOW) to confirm no orphan data.
137
+
138
+ ---
139
+
140
+ ## COM Error Recovery (Windows)
141
+
142
+ When an Excel API call fails with a COM error, **DO NOT switch to UIA**. Follow this recovery sequence:
143
+
144
+ | Step | Action | Details |
145
+ |------|--------|---------|
146
+ | 1 | Wait 3 seconds | COM object may be temporarily unavailable |
147
+ | 2 | Retry same API call | Interop has auto-reconnect logic |
148
+ | 3 | Check Excel health | Call `list-open-workbooks` — if it responds, call `open-or-attach-workbook` to reconnect |
149
+ | 4 | If all fail | Tell user: "Excel became unresponsive. Please close any Excel windows and try again." |
150
+ | 5 | Fall back to build-sheet | If `build-workbook` specifically fails after retries |
151
+ | 6 | UIA as absolute last resort | Only after ALL API recovery steps have been exhausted |
152
+
153
+ **Common COM errors:**
154
+
155
+ | Error | Meaning | Recovery |
156
+ |-------|---------|----------|
157
+ | `RPC_E_DISCONNECTED (0x80010108)` | Excel process died or zombie blocking | Close Excel via Task Manager, retry |
158
+ | `RPC_E_SERVERCALL_RETRYLATER (0x8001010A)` | Excel is busy (dialog, calculating) | Auto-retried by interop — wait |
159
+ | `RPC_E_CALL_REJECTED (0x80010001)` | Excel rejected COM call | Auto-retried by interop — wait |
160
+ | `E_FAIL (0x80004005)` | Generic COM failure | Retry once, then fall back to build-sheet |
161
+
162
+ ---
163
+
164
+ ## build-sheet Fallback (Windows)
165
+
166
+ When `build-workbook` fails and you fall back to individual `build-sheet` calls:
167
+
168
+ 1. **`=@SheetName[Label]` resolves in `build-sheet` ONLY if the referenced sheet already exists** — server reads the referenced sheet's column A at call time. If a partial `build-workbook` failure left some sheets unwritten, refs to those sheets won't resolve.
169
+ 2. **Build in dependency order** — write referenced sheets BEFORE sheets that reference them. Same-sheet refs (`B[Label]` without `@`) always work since labels and dependents land in the same write.
170
+ 3. **For refs to sheets that aren't built yet, rewrite as explicit cell refs** — e.g., `=@Portfolio[TOTAL]` → `='Portfolio'!B24`. Use `read-range` after each sheet to find the actual row number.
171
+ 4. **Sheet names with spaces need single quotes** — `='US Stocks'!E10`
172
+ 5. **Verify every cross-sheet reference** — read 2–3 cells to confirm values are correct
173
+
174
+ **After the last sheet:** Call `save-workbook` and `get-status` to save and verify.
@@ -0,0 +1,46 @@
1
+ # Troubleshooting Reference
2
+
3
+ Complete troubleshooting table for Excel Architect. The top 5 most common issues are in the main skill file — consult this table for the full list.
4
+
5
+ ---
6
+
7
+ | # | Issue | Solution |
8
+ |---|-------|----------|
9
+ | 1 | Range timeout | Use specific range (e.g., `A1:A100`), never `A:A` or `1:1` |
10
+ | 2 | Sheet not found | Use exact names from `get-workbook-info` |
11
+ | 3 | `#REF!` error | Sheet name in formula doesn't match actual — run `get-workbook-info` |
12
+ | 4 | `#NAME?` error | Sheet name with spaces missing quotes, or typo in function name |
13
+ | 5 | `#VALUE!` error | Data has currency/% symbols as text — use numbers + numberFormat |
14
+ | 6 | `#DIV/0!` error | Denominator empty/zero — wrap with `IFERROR` or fix source data |
15
+ | 7 | Write is slow | Batch ALL data in ONE `write-range` call |
16
+ | 8 | `#######` in cells | Auto-fit columns |
17
+ | 9 | Stale data | Read dimensions before operating |
18
+ | 10 | Wrong workbook targeted | Always pass workbookId or filePath |
19
+ | 11 | Chart appears empty/flat | Source column has no formulas — write formulas first, then chart |
20
+ | 12 | `build-sheet` cross-refs broken | `=@SheetName[Label]` works in `build-sheet` only if the referenced sheet already exists in the workbook. Build in dependency order, or use explicit `='Sheet'!B24` refs for sheets not yet written |
21
+ | 13 | Dashboard shows wrong values | Cross-sheet ref points to wrong cell — read target cell to verify |
22
+ | 14 | All cross-sheet formulas `#REF!` | Sheet name mismatch — run `get-workbook-info` to check |
23
+ | 15 | `get-status` returns empty but errors exist | Data beyond row 1000 or column AE not scanned; 10-second timeout |
24
+ | 16 | Reported values don't match file | Always `read-range` actual cell before reporting — never compute mentally |
25
+ | 17 | COM error (`RPC_E_DISCONNECTED`) | Wait 3s, retry. See `reference/repair.md` §COM Error Recovery |
26
+ | 18 | `build-workbook` fails on creation | Retry once. If still failing, use `create-workbook` + `build-sheet` individually |
27
+ | 19 | `write-range` returns 200 but cells empty | Write silently failed — `read-range` to verify, then retry |
28
+ | 20 | Data column overwritten with formulas | NEVER put computed formulas in raw data columns. Totals go in separate columns |
29
+ | 21 | Dashboard shows $0 for cross-sheet refs | Target cell is empty — verify with `read-range` before writing formula |
30
+ | 22 | All Weight % show 0.0% | Total row (divisor) empty — `write-range` silently failed. Rewrite total first |
31
+ | 23 | Pie chart empty or wrong data | Use single-column `valueRange` — see `reference/api/advanced.md` §Pie & Doughnut Charts |
32
+ | 24 | Chart API response has WARNINGs | Source data empty/zero or pie has multiple series. Fix data, recreate chart |
33
+ | 25 | Orphan data rows after corrections | Multiple writes to overlapping areas. Clear range first, or write complete data |
34
+ | 26 | Chart shows zeros despite data | Chart created BEFORE formulas. Write formulas first, then create chart |
35
+ | 27 | Fixing formulas makes things worse | STOP. Read with `returnFormulas: true` first. See `reference/repair.md` |
36
+ | 28 | Same error keeps recurring | Fixing symptom, not cause. Read the referenced cell — problem is in SOURCE data |
37
+ | 29 | Agent loops endlessly | Respect stop conditions: max 3 per cell, max 10 total repairs |
38
+ | 30 | Chart broken after fixing source | Chart was created with wrong range. `delete-chart` → recreate with correct params |
39
+ | 31 | Dashboard built before source sheets | Follow Phase 3 build order: foundation → computed → aggregation |
40
+ | 32 | Formula references wrong row | Read source sheet to find correct row — don't guess |
41
+ | 33 | Many errors in Phase 5 | You skipped Phase 3 incremental verification. Health-check each sheet |
42
+ | 34 | Agent rewrites formulas repeatedly | STOP — `read-range` with `returnFormulas: true` to understand what's wrong |
43
+ | 35 | Cross-sheet formula points to label | Formula says `=Sheet!A12` (label) instead of `=Sheet!B12` (value). Verify column letter |
44
+ | 36 | Archetype doesn't match request | Pick closest archetype, then customize. Archetype is a starting point |
45
+ | 37 | No research results found | Use reasonable defaults and note assumptions to user |
46
+ | 38 | Model invents structure | Re-read archetype file. Sheet structure and row layouts are mandatory |