@uipath/delegate-sdk 1.203.0 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,102 @@
1
+ # Quality Assurance
2
+
3
+ ## Health Check — MANDATORY (Do NOT skip)
4
+
5
+ **After creating or editing a document, you MUST run a health check before telling the user you are done.** Do NOT fabricate a health check — use the real tools below.
6
+
7
+ ### macOS: `/word/get-status`
8
+
9
+ Call via `ExecuteSkillApi`:
10
+ ```
11
+ endpoint: "/word/get-status"
12
+ body: { "filePath": "..." }
13
+ ```
14
+
15
+ This runs `health-check.applescript` which performs **automated validation** on the live Word document:
16
+ - **Structure:** heading hierarchy (skipped levels, missing H1), heading count
17
+ - **Text:** excessive empty paragraphs, trailing blank paragraphs (causes empty last page)
18
+ - **Fonts:** body font consistency (flags >3 fonts), font size consistency
19
+ - **Tables:** empty tables, missing bold header rows, empty cells
20
+ - **Hyperlinks:** empty addresses, raw URL display text
21
+ - **Images:** oversized images (wider than content area), very small images
22
+ - **Spacing:** inconsistent paragraph spacing values
23
+
24
+ Returns JSON with `isHealthy`, `issues[]` (each with severity, category, message, location, recommendation), and `healthSummary`.
25
+
26
+ **If blocking issues are found → fix them before informing the user.** Apply the convergence rules below to non-blocking findings.
27
+
28
+ ### Windows: Manual Check
29
+
30
+ No automated health check endpoint exists for Word on Windows. Run these checks manually:
31
+
32
+ 1. `/word/get/document-structure` — verify heading hierarchy, no skipped levels
33
+ 2. `/word/get/text` — scan for placeholder text (`[TOC]`, `UPDATED_TOC_FIELD`), double spaces
34
+ 3. `/word/get/textformatting` — verify font consistency (max 2 body fonts)
35
+ 4. `/word/get/tables` — check tables have content, headers are bold
36
+ 5. `/word/find/text` with `searchText: " "` — find double spaces
37
+
38
+ **If blocking issues are found → fix them before informing the user.** Apply the convergence rules below to non-blocking findings.
39
+
40
+ ---
41
+
42
+ ## After Health Check Passes
43
+
44
+ ### Verify Requested Content
45
+
46
+ Regardless of platform, confirm all user-requested elements are present:
47
+ - Cover page with title, subtitle, author, date
48
+ - TOC (generated and updated — has entries, not empty or placeholder text)
49
+ - All requested sections with proper heading styles
50
+ - Tables with captions, no overflow
51
+ - Bookmarks on every H1 heading
52
+ - Left-aligned body text (never justified)
53
+
54
+ ### Ask About Full Review
55
+
56
+ **For non-trivial documents (more than 1 page or 3+ paragraphs): ASK the user if they want a full review via `Agent` with `agent_type: "review"`.**
57
+
58
+ > "Would you like me to do a full content review of the document before we're done?"
59
+
60
+ - User says yes → call `Agent` with `agent_type: "review"`
61
+ - User says no → inform user the document is ready
62
+
63
+ **The Agent review checks:** content completeness, accuracy, structure, spelling/grammar, fact-checking via WebSearch.
64
+
65
+ ### Review Convergence — MANDATORY
66
+
67
+ Classify every review finding before making another edit:
68
+
69
+ - **Blocking:** corrupt/unopenable output, missing requested content, factual or source-integrity errors, invalid calculations, placeholder text, clipped/overflowing content, or a structural defect that makes the document unusable.
70
+ - **Non-blocking:** cosmetic whitespace, readable-but-imperfect wrapping, minor pagination preferences, or an isolated heading/caption placement that does not hide or detach content.
71
+
72
+ Run at most **one complete review and one corrective edit/regeneration pass**. After that correction, verify only the changed areas plus the mandatory health check; do not launch another complete review. If a blocking defect remains, report it clearly and preserve the latest usable artifact instead of looping. Non-blocking findings never prevent handoff.
73
+
74
+ Do not introduce static page-number tokens or an exact page map merely to chase cosmetic pagination. If the user or active workflow explicitly requires a deterministic static TOC, use its bounded file-only finalizer and do not alternate it with live Word field updates; that combination recreates the review/finalization loop.
75
+
76
+ ---
77
+
78
+ ## Common Issues & Fixes
79
+
80
+ | Issue | Cause | Fix |
81
+ |-------|-------|-----|
82
+ | **Empty page at end** | Trailing empty paragraphs or page break | Delete trailing empty paragraphs via `/word/selection/delete` |
83
+ | **Table overflows page** | Too many/wide columns | AutoFit to Window or reduce content. See `reference/tables.md` |
84
+ | **TOC not updating** | Headings changed | /word/update/toc (both platforms) |
85
+ | **Heading style not applied** | Missing `/word/apply/style` call | Apply style with range covering the heading paragraph |
86
+ | **Inconsistent formatting** | Mixed manual styles | Check with `/word/get/textformatting`, fix with `/word/format/text` |
87
+ | **Placeholder text left in** | `[TOC]`, `UPDATED_TOC_FIELD` | `/word/find/text` → `/word/selection/delete` |
88
+ | **Orphaned captions** | Image insertion failed | Remove caption or re-insert image |
89
+ | **Skipped heading levels** | H1 → H3 without H2 | Add intermediate heading or adjust level |
90
+
91
+ ---
92
+
93
+ ## Anti-Patterns
94
+
95
+ **Never:**
96
+ - Skip the health check or substitute it with `ReadFile` on macOS
97
+ - Fabricate a health check table without actually running the tool
98
+ - Insert tables without checking for overflow
99
+ - Forget page breaks between major sections (H1)
100
+ - Create tables with 5+ columns without planning for page width
101
+ - Leave the document without updating the TOC after heading changes
102
+ - Skip applying heading styles to section titles
@@ -0,0 +1,62 @@
1
+ # Tables Reference
2
+
3
+ ## Table Design Rules
4
+
5
+ - **Always use `width: 100%`** — both in generator and when using HTML/API
6
+ - **Cell padding is critical** — default: 80 twips top/bottom, 120 twips left/right (~4pt/6pt)
7
+ - **Use `ShadingType.CLEAR` not `SOLID`** for cell backgrounds in the generator — `SOLID` produces black boxes in some Word versions
8
+ - **Column limits:**
9
+ - Letter (8.5x11"): max 5-6 columns
10
+ - A4: max 4-5 columns
11
+ - 7+ columns: split into two tables, use landscape, or abbreviate headers
12
+ - **Alternating row colors** improve readability — enabled by default in consulting, modern, and corporate themes
13
+ - **Align numbers right** in data columns; left-align text columns
14
+ - **Header row always bold with contrasting background** — never leave headers unstyled
15
+
16
+ ---
17
+
18
+ ## Theme Table Styles
19
+
20
+ Each generator theme produces distinct table styling:
21
+
22
+ | Theme | Header bg | Alt row bg | Border |
23
+ |-------|-----------|------------|--------|
24
+ | **Consulting** (navy) | `#2F5496` white text | `#D6E4F0` | `#B4C6E7` 1pt |
25
+ | **Modern** (teal) | `#0F7B6C` white text | `#E6F2F0` | `#A8D5CF` 1pt |
26
+ | **Corporate** (dark blue) | `#1B3A5C` white text | `#E8EDF2` | `#B0BEC5` 1pt |
27
+
28
+ ---
29
+
30
+ ## Table Overflow Prevention
31
+
32
+ ### The Problem
33
+ Tables can overflow page margins — text cut off, unprofessional appearance, print issues.
34
+
35
+ ### Prevention
36
+
37
+ 1. **Design for page width BEFORE insertion:**
38
+ - 2 columns: safe (50% each)
39
+ - 3 columns: safe (33% each)
40
+ - 4 columns: caution (25% each, keep content short)
41
+ - 5+ columns: use AutoFit or split
42
+
43
+ 2. **Use `width: 100%`** in HTML tables. For precise control:
44
+ ```html
45
+ <table style='width:100%; table-layout:fixed;'>
46
+ <colgroup>
47
+ <col style='width:30%'>
48
+ <col style='width:70%'>
49
+ </colgroup>
50
+ </table>
51
+ ```
52
+
53
+ 3. **Keep cell content concise** — abbreviations, 2-3 lines max, minimal bullet points
54
+
55
+ ### Fixing Overflow
56
+
57
+ **AutoFit (preferred):** Click inside table → Table Layout tab → AutoFit → AutoFit Window
58
+
59
+ **Manual:** Drag right edge inward, or double-click column borders
60
+
61
+ ### Verify After EVERY Table Insert
62
+ Check in screenshot: full table width visible? Right edge within page? All text visible?
@@ -0,0 +1,34 @@
1
+ # Tracked Changes & Comments (Windows Only)
2
+
3
+ Track changes and comments can be managed via C# scripting using the `/word/execute-script` endpoint. These operations require the document to be open via `/word/open-attach`.
4
+
5
+ ## Enable/Disable Track Changes
6
+
7
+ ```csharp
8
+ document.TrackRevisions = true; // Enable
9
+ document.TrackRevisions = false; // Disable
10
+ ```
11
+
12
+ ## Accept All Changes
13
+
14
+ ```csharp
15
+ document.AcceptAllRevisions();
16
+ return "All changes accepted";
17
+ ```
18
+
19
+ ## Reject All Changes
20
+
21
+ ```csharp
22
+ document.RejectAllRevisions();
23
+ return "All changes rejected";
24
+ ```
25
+
26
+ ## Add a Comment to a Text Range
27
+
28
+ ```csharp
29
+ dynamic range = document.Range(startPos, endPos);
30
+ document.Comments.Add(range, "Review comment text");
31
+ return "Comment added";
32
+ ```
33
+
34
+ Use `/word/get/text` or `/word/find/text` to determine the character positions (`startPos`, `endPos`) for the range you want to comment on.
@@ -0,0 +1,231 @@
1
+ # UIA Fallback Guide for Word
2
+
3
+ **Load this file when the Word API (`/word/*`) fails and you need to fall back to AppAct (UI automation).**
4
+
5
+ ---
6
+
7
+ ## When to Use UIA
8
+
9
+ | Situation | Action |
10
+ |-----------|--------|
11
+ | API endpoint returned error twice | Fall back to UIA for that specific operation |
12
+ | SmartArt insertion | UIA only — no API endpoint |
13
+ | Color picker (font/highlight/shading) | UIA only — opens a separate dialog |
14
+ | Ribbon-only features (Design tab, Watermark, etc.) | UIA only |
15
+ | API works but result is wrong (formatting didn't apply) | Retry via UIA |
16
+
17
+ **NEVER use UIA as the first attempt** — always try the API first.
18
+
19
+ **When you do fall back to UIA, prefer `paste_content` with HTML** over clicking individual ribbon buttons. One paste can insert fully formatted content (tables, headings, lists, styled text) in a single action.
20
+
21
+ ---
22
+
23
+ ## Keyboard Shortcuts (Windows)
24
+
25
+ | Action | Shortcut |
26
+ |--------|----------|
27
+ | Save | `Ctrl+S` |
28
+ | Undo / Redo | `Ctrl+Z` / `Ctrl+Y` |
29
+ | Select All | `Ctrl+A` |
30
+ | Copy / Paste / Cut | `Ctrl+C` / `Ctrl+V` / `Ctrl+X` |
31
+ | Bold / Italic / Underline | `Ctrl+B` / `Ctrl+I` / `Ctrl+U` |
32
+ | Strikethrough | `Alt+H, 4` |
33
+ | Subscript / Superscript | `Ctrl+=` / `Ctrl+Shift+=` |
34
+ | Page Break | `Ctrl+Enter` |
35
+ | Find / Replace | `Ctrl+F` / `Ctrl+H` |
36
+ | Heading 1/2/3 | `Ctrl+Alt+1` / `Ctrl+Alt+2` / `Ctrl+Alt+3` |
37
+ | Normal style | `Ctrl+Shift+N` |
38
+ | Go to beginning / end | `Ctrl+Home` / `Ctrl+End` |
39
+ | Select to beginning / end | `Ctrl+Shift+Home` / `Ctrl+Shift+End` |
40
+ | Select word | `Ctrl+Shift+Right` (or Left) |
41
+ | Select paragraph | Triple-click |
42
+ | Select line | `Home`, then `Shift+End` |
43
+ | Page down / up | `PgDn` / `PgUp` |
44
+ | Zoom in / out | `Ctrl+Mouse wheel` or `Ctrl+=` / `Ctrl+-` |
45
+ | Navigation pane | `Ctrl+F` (then use headings panel) |
46
+ | Print | `Ctrl+P` |
47
+
48
+ ## Keyboard Shortcuts (macOS)
49
+
50
+ | Action | Shortcut |
51
+ |--------|----------|
52
+ | Save | `Cmd+S` |
53
+ | Undo / Redo | `Cmd+Z` / `Cmd+Shift+Z` |
54
+ | Select All | `Cmd+A` |
55
+ | Copy / Paste / Cut | `Cmd+C` / `Cmd+V` / `Cmd+X` |
56
+ | Bold / Italic / Underline | `Cmd+B` / `Cmd+I` / `Cmd+U` |
57
+ | Strikethrough | `Cmd+Shift+X` |
58
+ | Subscript / Superscript | `Cmd+=` / `Cmd+Shift+=` |
59
+ | Page Break | `Cmd+Enter` |
60
+ | Find / Replace | `Cmd+F` / `Cmd+Shift+H` |
61
+ | Heading 1/2/3 | `Cmd+Option+1` / `Cmd+Option+2` / `Cmd+Option+3` |
62
+ | Normal style | `Cmd+Shift+N` |
63
+ | Go to beginning / end | `Cmd+Home` (or `Cmd+Up`) / `Cmd+End` (or `Cmd+Down`) |
64
+ | Select to beginning / end | `Cmd+Shift+Home` / `Cmd+Shift+End` |
65
+ | Select word | `Option+Shift+Right` (or Left) |
66
+ | Select paragraph | Triple-click |
67
+ | Select line | `Cmd+Left`, then `Cmd+Shift+Right` |
68
+ | Page down / up | `Fn+Down` / `Fn+Up` |
69
+ | Navigation pane | `Cmd+F` |
70
+ | Print | `Cmd+P` |
71
+
72
+ ---
73
+
74
+ ## Paste Content — The Power Move
75
+
76
+ **When editing via UIA, prefer `paste_content` with HTML over clicking ribbon buttons.** One paste can insert a fully formatted heading + table + paragraphs in a single action — no multi-step ribbon clicks, no formatting misses.
77
+
78
+ ### Why paste_content > individual UIA actions
79
+ - Insert a **formatted table** with headers, colors, and borders in one shot
80
+ - Insert a **heading + paragraph + list** together with correct styles
81
+ - Insert **rich content** (bold, italic, links, colors) without touching the ribbon
82
+ - Works on both Windows and macOS
83
+
84
+ ### Basic usage
85
+ ```json
86
+ {
87
+ "type": "paste_content",
88
+ "payload": {
89
+ "content": "<h2>Key Findings</h2><p>Revenue grew <b>15%</b> year-over-year.</p>",
90
+ "contentType": "html",
91
+ "fontFamily": "Calibri",
92
+ "fontSize": "11pt"
93
+ }
94
+ }
95
+ ```
96
+
97
+ ### Insert a formatted table
98
+ ```json
99
+ {
100
+ "type": "paste_content",
101
+ "payload": {
102
+ "content": "<table border='1' cellpadding='8' cellspacing='0' style='border-collapse: collapse; width: 100%;'><tr style='background-color: #2F5496; color: white;'><th>Metric</th><th>Q1</th><th>Q2</th></tr><tr><td>Revenue</td><td>$3.2M</td><td>$4.1M</td></tr><tr style='background-color: #D6E4F0;'><td>Margin</td><td>42%</td><td>45%</td></tr></table>",
103
+ "contentType": "html",
104
+ "fontFamily": "Calibri"
105
+ }
106
+ }
107
+ ```
108
+
109
+ ### Insert heading + content together
110
+ ```json
111
+ {
112
+ "type": "paste_content",
113
+ "payload": {
114
+ "content": "<h1>3. Financial Analysis</h1><p>The company demonstrated strong performance across all segments.</p><ul><li>Revenue: <b>$4.1B</b> (+12% YoY)</li><li>Operating margin: <b>28%</b> (up 3pp)</li></ul>",
115
+ "contentType": "html",
116
+ "fontFamily": "Calibri",
117
+ "fontSize": "11pt"
118
+ }
119
+ }
120
+ ```
121
+
122
+ ### Professional table header colors
123
+
124
+ See [reference/tables.md](tables.md) for theme table styles. Common HTML header colors:
125
+ `#2F5496` (navy), `#4472C4` (blue), `#70AD47` (green), `#C00000` (red), `#5C2D91` (purple) — all with `color: white`.
126
+
127
+ ### Spacing in HTML
128
+
129
+ Always add `<p>&nbsp;</p>` **after tables** to prevent content from appearing cramped:
130
+ ```html
131
+ <table>...</table>
132
+ <p>&nbsp;</p>
133
+ <p>Content continues here...</p>
134
+ ```
135
+
136
+ ### Ready-to-use HTML layout templates
137
+
138
+ For complex paste_content patterns (KPI tables, comparison tables, RACI matrices, callout boxes, timelines), load from `reference/html-layouts/`:
139
+
140
+ | File | Pattern |
141
+ |------|---------|
142
+ | [01-executive-summary-box.md](html-layouts/01-executive-summary-box.md) | Highlighted key findings box with left accent border |
143
+ | [02-kpi-summary-table.md](html-layouts/02-kpi-summary-table.md) | Metric cards with color-coded values |
144
+ | [03-comparison-table.md](html-layouts/03-comparison-table.md) | Side-by-side feature/option comparison |
145
+ | [04-pros-cons-table.md](html-layouts/04-pros-cons-table.md) | Two-column advantages vs disadvantages |
146
+ | [05-timeline-table.md](html-layouts/05-timeline-table.md) | Horizontal project phases/milestones |
147
+ | [06-raci-matrix.md](html-layouts/06-raci-matrix.md) | Responsibility assignment matrix |
148
+ | [07-data-table-alternating.md](html-layouts/07-data-table-alternating.md) | Alternating row data table |
149
+ | [08-callout-box.md](html-layouts/08-callout-box.md) | Info/warning/tip/success callout boxes |
150
+ | [09-vertical-milestone.md](html-layouts/09-vertical-milestone.md) | Vertical milestone tracker with status |
151
+
152
+ Load these on demand when you need a specific pattern — don't load all at once.
153
+
154
+ ### Tips
155
+ - **Always set `fontFamily`** to match the document's existing font (check first with `/word/get/styledtext` or the Styles gallery)
156
+ - **Use `width: 100%`** on tables to prevent overflow
157
+ - **Use inline styles** for colors — Word respects `style='color: #2F5496; font-weight: bold;'`
158
+ - **Emoji:** See `api/expert.md` for encoding rules
159
+ - **Position cursor first** before pasting — navigate to the right spot, then paste
160
+ - **Page breaks in HTML:** Use `<br style='page-break-before: always;'>` or insert a page break via keyboard (`Ctrl+Enter` / `Cmd+Enter`) before pasting
161
+
162
+ ---
163
+
164
+ ## Common AppAct Patterns
165
+
166
+ ### Navigate to a heading (when API can't scroll)
167
+ ```json
168
+ { "type": "key_combination", "payload": { "keys": ["ctrl", "Home"] } }
169
+ ```
170
+ Then use Find (`Ctrl+F` / `Cmd+F`) to jump to specific text.
171
+
172
+ ### Select a table for AutoFit
173
+ Click on a **specific cell's text** (NOT "the table" generically):
174
+ ```json
175
+ {
176
+ "type": "click",
177
+ "payload": {
178
+ "elementDescription": "The 'Revenue' text in the first row of the financial data table",
179
+ "clickType": "single"
180
+ }
181
+ }
182
+ ```
183
+ Then: Table Layout tab → AutoFit → AutoFit Window.
184
+
185
+ ### Apply heading style via ribbon
186
+ 1. Triple-click to select the heading text
187
+ 2. Click "Heading 1" in the Styles gallery (Home tab)
188
+
189
+ Or use keyboard: `Ctrl+Alt+1` (Windows) / `Cmd+Option+1` (macOS)
190
+
191
+ ### Insert page break
192
+ Position cursor, then `Ctrl+Enter` (Windows) / `Cmd+Enter` (macOS).
193
+
194
+ ### Select and delete a section
195
+ 1. Click at the start of the section
196
+ 2. Scroll to the end, hold Shift, click at the end
197
+ 3. Press `Delete`
198
+
199
+ Or use Find to locate the start text, then Shift+click at the end.
200
+
201
+ ### Ribbon tab navigation (Windows)
202
+ Use `Alt` to activate ribbon, then tab letters:
203
+ - `Alt+H` = Home
204
+ - `Alt+N` = Insert
205
+ - `Alt+P` = Design (Page Layout)
206
+ - `Alt+R` = Review
207
+ - `Alt+W` = View
208
+ - Arrow keys to navigate within a tab
209
+
210
+ ### Ribbon tab navigation (macOS)
211
+ Click the tab directly — macOS Word doesn't support Alt-key ribbon shortcuts. Use AppAct:
212
+ ```json
213
+ {
214
+ "type": "click",
215
+ "payload": {
216
+ "elementDescription": "The 'Insert' tab in the Word ribbon",
217
+ "clickType": "single"
218
+ }
219
+ }
220
+ ```
221
+
222
+ ---
223
+
224
+ ## Gotchas
225
+
226
+ - **macOS color picker** opens a separate window. Check `AvailableApplicationWindows`, switch to it, use arrow keys, press Enter. NEVER type in the main document while the picker is open.
227
+ - **Tables inflate click targets.** When clicking a table, always target specific cell text, not "the table".
228
+ - **Ribbon state matters.** Check which tab is active before clicking ribbon buttons. If the wrong tab is showing, click the right tab first.
229
+ - **Dialogs block.** Some operations open modal dialogs (Print, Save As, Find). Always close them before continuing.
230
+ - **Scroll before click.** If the target element isn't visible, scroll first (PgDn/PgUp or scroll action), then click.
231
+ - **Page navigation key names.** Use `[k(pgdn)]` and `[k(pgup)]` — NOT `[k(pagedown)]` or `[k(page_down)]`. Wrong names cause syntax errors.
@@ -0,0 +1,82 @@
1
+ # Visual Elements Reference
2
+
3
+ ## Charts — Design Best Practices
4
+
5
+ ### Chart Types and When to Use
6
+
7
+ | Chart Type | Best For | Example Use Cases |
8
+ |------------|----------|-------------------|
9
+ | **Column** | Comparing values across categories | Quarterly sales by region, budget vs actual |
10
+ | **Bar** | Horizontal comparison (long labels) | Product rankings, department performance |
11
+ | **Line** | Trends over time | Revenue growth, market share evolution |
12
+ | **Pie** | Part-to-whole (5-6 max slices) | Market share, budget allocation |
13
+ | **Area** | Cumulative trends | Stacked revenue streams, growth patterns |
14
+ | **Scatter** | Correlation between two variables | Price vs demand, effort vs outcome |
15
+
16
+ ### Sizing
17
+
18
+ - Inline chart: 300-400pt width, 200-300pt height
19
+ - Full-width chart: 468pt width (matches page content at 1" margins)
20
+ - Keep height proportional — 400pt wide works well at 250-300pt height
21
+
22
+ ### Color Consistency
23
+
24
+ - Use theme accent colors for data series (e.g., consulting: `#2F5496`, `#4472C4`, `#B4C6E7`)
25
+ - Same color for the same category across all charts in the document
26
+ - Max 5 distinct colors per chart
27
+
28
+ ### Multi-Series Guidance
29
+
30
+ - Max 4-5 series per chart for readability
31
+ - 2-3 series: grouped column or line chart
32
+ - Single series with many categories: horizontal bar
33
+ - More than 5 series: split into multiple charts or use a data table
34
+
35
+ ### Chart + Table Pattern
36
+
37
+ - Show the chart for the visual story (trends, comparisons, proportions)
38
+ - Include supporting data table in an appendix for exact values
39
+ - Reference the appendix table in a footnote below the chart
40
+
41
+ ### When to Use Charts (by template)
42
+
43
+ - **Professional/Academic**: Chart after every data table. DIVERSIFY types (column, pie, line, bar, radar). Never repeat the same type twice in a row.
44
+ - **Educational/Kids**: Bar charts for size/speed comparisons. Use sparingly — tables are more fun for kids.
45
+ - **Creative**: Only for budgets, timelines, or rating comparisons.
46
+ - **Operational**: Only if data visualization adds real value (burndown, timeline).
47
+
48
+ ### When NOT to Use Charts
49
+
50
+ - Fewer than 3 data points — use a sentence or callout box
51
+ - When exact values matter more than trends — use a formatted table
52
+ - When all values are nearly identical — the chart adds no insight
53
+ - Single data point comparisons — use a KPI callout or bold text
54
+
55
+ ---
56
+
57
+ ## SmartArt Categories
58
+
59
+ Use SmartArt for processes, hierarchies, and relationships. **Insertion uses helper scripts** — see your platform SKILL file (SKILL.windows.md or SKILL.macos.md) for the exact commands.
60
+
61
+ | Category | Best For | Examples |
62
+ |----------|----------|----------|
63
+ | **Process** | Sequential workflows | Project phases, approval flows |
64
+ | **Hierarchy** | Organizational structures | Org charts, decision trees |
65
+ | **Cycle** | Repeating processes | Feedback loops, continuous improvement |
66
+ | **List** | Enhanced bullet points | Features list, key points |
67
+ | **Relationship** | Connections between concepts | Venn diagrams, interlocking ideas |
68
+ | **Matrix** | Grid relationships | Risk/impact matrices, 2x2 analysis |
69
+ | **Pyramid** | Proportional/layered concepts | Priority levels, value hierarchy |
70
+
71
+ ---
72
+
73
+ ## Cover Page Styles
74
+
75
+ Word built-in cover page templates. **Insertion uses helper scripts** — see your platform SKILL file.
76
+
77
+ | Style | Look |
78
+ |-------|------|
79
+ | **Facet** | Modern, geometric design |
80
+ | **Motion** | Dynamic, professional |
81
+ | **Ion** | Clean, minimalist |
82
+ | **Sideline** | Classic sidebar design |