@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,430 @@
1
+ ---
2
+ name: uipath-workflow-documenter
3
+ friendly_name: UiPath Workflow Documenter
4
+ version: 1.0.0
5
+ description: Reverse-engineer an existing UiPath workflow (`.xaml` file or Orchestrator process key/package) into a Word `.docx`. Trigger ONLY when the user has a concrete workflow file path or Orchestrator process key in hand.
6
+ icon: FaFileContract
7
+ color: 0078D4
8
+ ---
9
+
10
+ # PDD Generator
11
+
12
+ Generate a professional **Process Definition Document (PDD)** as a Word document. Supports two input modes: analyzing a local UiPath `.xaml` workflow file, or fetching a deployed package from Orchestrator.
13
+
14
+ ## When to Use
15
+
16
+ Activate when the user:
17
+ - Provides a `.xaml` workflow file path and asks for documentation
18
+ - Names a deployed process in Orchestrator and wants it documented
19
+ - Has a built workflow they want reverse-engineered into a `.docx`
20
+
21
+ Do NOT activate for from-scratch process documentation, verbal walkthroughs, or scoping a new automation candidate — that's `business-analysis`.
22
+
23
+ ## How to Use
24
+
25
+ ### Step 1: Determine Input Mode and Template
26
+
27
+ Ask the user **two questions** before proceeding:
28
+
29
+ **Question 1: Input source**
30
+
31
+ | Mode | Input | Best for |
32
+ |------|-------|----------|
33
+ | **Workflow analysis** | `.xaml` file path | Documenting an existing UiPath automation |
34
+ | **From Orchestrator** | Process name in Orchestrator | Documenting a deployed production process |
35
+
36
+ **Question 2: Document template**
37
+
38
+ Ask: "Do you have a corporate or custom Word template (.docx) you'd like me to use for the PDD, or should I use the default professional template?"
39
+
40
+ | Option | What happens |
41
+ |--------|-------------|
42
+ | **User provides a `.docx` template** | Follow **Custom Template Mode** in Step 4 (use `templatePath`, match template's section structure and styling) |
43
+ | **No template / use default** | Use `"theme": "consulting"` with the standard PDD layout |
44
+
45
+ If the user does not mention a template, proceed with the default. Do NOT skip this question.
46
+
47
+ ### Step 2: Gather Process Information
48
+
49
+ #### Mode A: From .xaml Workflow
50
+
51
+ 1. Use `file_discovery` to locate the `.xaml` file if the user gives a partial name
52
+ 2. Read the `.xaml` file using `read_file`
53
+ 3. **MANDATORY EXTRACTION CHECKLIST** - complete every item before moving to Step 4. Do NOT skip any item. For each, record findings verbatim in your scratchpad:
54
+
55
+ - [ ] **Workflow type**: Sequence / Flowchart / StateMachine
56
+ - [ ] **Arguments**: list every `x:Property` with Name, Direction (In/Out/InOut), Type
57
+ - [ ] **All declared variables**: list every `Variable` element with Name, Type, Default
58
+ - [ ] **Unused variables**: for EACH declared variable, grep the file for its Name. If only referenced in its own declaration, flag it. This MUST appear as a risk in Section 4.1
59
+ - [ ] **Applications used**: scan `xmlns:*` for namespaces (UiPath.Excel, UiPath.Mail, UiPath.UIAutomation, SAP, etc.) AND DisplayName attributes for app hints
60
+ - [ ] **All activities (count them)**: count every activity with a DisplayName. If >10 activities, Section 2.4 MUST have a minimum of `ceil(activityCount / 3)` detailed step subsections. Do NOT condense a 14-activity workflow into 3 steps
61
+ - [ ] **Decision points**: every `If.Condition`, `FlowDecision.Condition`, `Transition.Condition`, `Switch` - extract the exact C# or VB expression verbatim
62
+ - [ ] **Loops**: every `ForEach`, `ForEachRow`, `While`, `DoWhile` - note collection and iteration pattern
63
+ - [ ] **Exception handling**: every `TryCatch`, `RetryScope`. If NONE exist, this becomes a HIGH risk in Section 4.1 with mitigation "Add TryCatch blocks before production deployment"
64
+ - [ ] **Explicit `Throw` activities**: business exceptions thrown by the workflow (e.g., BusinessRuleException). These belong in Section 3.5 Business Exceptions table
65
+ - [ ] **Sub-workflows**: every `InvokeWorkflowFile` - record the `WorkflowFileName` and arguments passed. These MUST produce:
66
+ - A subsection in Section 2.4 documenting the call
67
+ - An entry in Appendix E (Call Hierarchy) showing parent -> child relationship
68
+ - [ ] **State Machine specifics** (if applicable): every `State` with entry actions, every `Transition` with condition, every feedback loop (state revisited)
69
+ - [ ] **Activity annotations**: DisplayName attributes often contain human-readable step descriptions, use them verbatim when possible
70
+
71
+ #### Mode B: From Orchestrator Process
72
+
73
+ Fetch a deployed process package directly from UiPath Orchestrator, extract the `.xaml` files, and generate the PDD without needing a local copy.
74
+
75
+ **Prerequisites:** User must be authenticated with UiPath (access token available in auth store).
76
+
77
+ **IMPORTANT:** Before using any Orchestrator API, read `uipath-orchestrator/SKILL.md` and `uipath-orchestrator/reference/endpoints.md` for the full endpoint reference and error handling guidance.
78
+
79
+ **Step C1: List folders**
80
+
81
+ Use the built-in `GetUserFolders` tool first (auto-executes, no params needed). It calls `orchestrator_/api/Folders/GetAllForCurrentUser` and returns all folders with `id`, `displayName`, `path`, `folderType`, and `isPersonal`.
82
+
83
+ If `GetUserFolders` is not available, fall back to `SendUiPathRequest`:
84
+
85
+ ```
86
+ SendUiPathRequest:
87
+ method: GET
88
+ path: orchestrator_/api/FoldersNavigation/GetAllFoldersForCurrentUser
89
+ toolName: "List Folders"
90
+ description: "Getting all Orchestrator folders for the current user"
91
+ ```
92
+
93
+ Response contains `Id` (numeric, used as `X-UIPATH-OrganizationUnitId`), `DisplayName`, and `FullyQualifiedName` for each folder. Ask the user which folder contains the process, or search all folders if unknown.
94
+
95
+ **Do NOT use** `orchestrator_/odata/Folders` for listing user folders. It may return folders the user does not have access to. Use the REST API endpoints above which are scoped to the current user.
96
+
97
+ **Step C2: List deployed processes (Releases) in the folder**
98
+
99
+ Releases are **folder-scoped**. You MUST pass the folder ID as a query parameter:
100
+
101
+ ```
102
+ SendUiPathRequest:
103
+ method: GET
104
+ path: orchestrator_/odata/Releases?X-UIPATH-OrganizationUnitId={folderId}&$select=Key,Name,ProcessKey,ProcessVersion,FeedId,IsLatestVersion,Arguments
105
+ toolName: "List Releases"
106
+ description: "Getting deployed processes from folder"
107
+ ```
108
+
109
+ To search by name:
110
+ ```
111
+ path: orchestrator_/odata/Releases?X-UIPATH-OrganizationUnitId={folderId}&$filter=contains(Name, '{searchTerm}')
112
+ ```
113
+
114
+ To get only latest versions:
115
+ ```
116
+ path: orchestrator_/odata/Releases?X-UIPATH-OrganizationUnitId={folderId}&$filter=IsLatestVersion eq true
117
+ ```
118
+
119
+ **If no results:** The folder may be empty or the user may need a different folder. Try listing all folders and searching each one, or ask the user to confirm the folder name.
120
+
121
+ **Key fields from Release response:**
122
+ - `Key` - Release key (GUID, used for starting jobs)
123
+ - `Name` - Display name
124
+ - `ProcessKey` - Package identifier (e.g., `MyProject.MyProcess`)
125
+ - `ProcessVersion` - Version string (e.g., `1.0.0`)
126
+ - `FeedId` - Package feed GUID (needed for download)
127
+ - `Arguments.Input` - JSON array of input arguments
128
+ - `Arguments.Output` - JSON array of output arguments
129
+
130
+ **Step C3: Get process input/output schema (optional but recommended)**
131
+
132
+ For traditional RPA processes:
133
+ ```
134
+ SendUiPathRequest:
135
+ method: GET
136
+ path: orchestrator_/odata/Processes/UiPath.Server.Configuration.OData.GetArguments(key='{ProcessKey}:{ProcessVersion}')
137
+ toolName: "Get Process Arguments"
138
+ description: "Getting input/output arguments schema"
139
+ ```
140
+
141
+ For modern processes (API/Agent, Studio 25.10+):
142
+ ```
143
+ SendUiPathRequest:
144
+ method: GET
145
+ path: orchestrator_/odata/Processes/UiPath.Server.Configuration.OData.GetPackageMainEntryPointV2(key='{ProcessKey}:{ProcessVersion}')?feedId={FeedId}
146
+ toolName: "Get Process Entry Point"
147
+ description: "Getting modern process schema and entry point"
148
+ ```
149
+
150
+ This provides the JSON Schema for input/output arguments, which goes into PDD Section 2.7 (Input and Output Data).
151
+
152
+ **Step C4: Download the .nupkg package**
153
+
154
+ Use the Libraries download endpoint (works for process packages too):
155
+ ```
156
+ SendUiPathRequest:
157
+ method: GET
158
+ path: orchestrator_/odata/Processes/UiPath.Server.Configuration.OData.DownloadPackage(key='{ProcessKey}:{ProcessVersion}')
159
+ responseType: binary
160
+ toolName: "Download Package"
161
+ description: "Downloading process package for .xaml extraction"
162
+ ```
163
+
164
+ **If this returns 404/403**, try the NuGet feed directly:
165
+ ```
166
+ SendUiPathRequest:
167
+ method: GET
168
+ path: orchestrator_/nuget/feed/{FeedId}/package/{ProcessKey}/{ProcessVersion}
169
+ responseType: binary
170
+ toolName: "Download Package (NuGet)"
171
+ description: "Downloading process package via NuGet feed"
172
+ ```
173
+
174
+ **If both fail**, fall back to:
175
+ 1. Ask the user to download the package manually from Orchestrator UI (Automations > Packages > Download)
176
+ 2. Or ask them to provide the `.xaml` files directly (switch to Mode A)
177
+
178
+ **Step C5: Extract .xaml files from the package**
179
+
180
+ The `.nupkg` is a standard zip file. After downloading, use the archive endpoint (`/file/archive`) to extract it. `SendUiPathRequest` saves the binary response to a file automatically when the response is >2KB.
181
+
182
+ ```
183
+ ExecuteSkillApi:
184
+ endpoint: "/file/archive"
185
+ body: {
186
+ "operation": "extract",
187
+ "archivePath": "{path-to-downloaded-nupkg}",
188
+ "destinationPath": "{tempDir}/{ProcessKey}-extracted"
189
+ }
190
+ toolName: "Extract Package"
191
+ description: "Extracting .nupkg archive to access .xaml files"
192
+ ```
193
+
194
+ After extraction, look for `.xaml` files in these locations (use `/file/list-files` with `recursive: true` and `pattern: "*.xaml"`):
195
+ - `lib/net45/*.xaml` (Legacy framework projects)
196
+ - `content/*.xaml` (Portable/Windows framework projects)
197
+ - Root level `*.xaml` (some packaging formats)
198
+
199
+ Also read `project.json` for metadata (dependencies, entry points, project settings) via `/file/read`.
200
+
201
+ **Step C6: Identify the entry point**
202
+
203
+ Read `project.json` from the extracted package to find:
204
+ - `main` field: the entry point `.xaml` file (usually `Main.xaml`)
205
+ - `dependencies`: packages used (reveals which activities/connectors are involved)
206
+ - `designOptions.projectProfile`: project type (Process, Library, TestAutomation)
207
+ - `entryPoints`: array of entry point files (modern projects may have multiple)
208
+
209
+ **Step C7: Analyze all .xaml files**
210
+
211
+ Read each `.xaml` file and follow the same extraction checklist as **Mode A**. For multi-file processes:
212
+ - Start with the entry point (`Main.xaml`)
213
+ - Follow `InvokeWorkflowFile` activities to discover sub-workflows
214
+ - Document the call hierarchy in **Appendix E** (parent -> child relationships)
215
+ - Each sub-workflow becomes a subsection in **Section 2.4** (Detailed Step-by-Step Description)
216
+
217
+ **Important notes:**
218
+ - If the download fails with 403/404, the user may not have permissions to download packages from that folder
219
+ - Some organizations disable package downloads via API. Fall back to asking the user to export from Studio or Orchestrator UI
220
+ - The `.nupkg` may contain compiled code (`.dll`) in addition to `.xaml`. Focus on `.xaml` files for PDD generation
221
+ - **Do NOT modify or re-upload** the package. This is read-only access for documentation purposes
222
+ - Even if download fails, you can still generate a partial PDD using the Release metadata (name, version, arguments) from Step C2-C3
223
+
224
+ ### Step 3: Research (if needed)
225
+
226
+ If the process involves well-known applications or standard business processes, use `WebSearch` to gather:
227
+ - Application-specific automation considerations
228
+ - Industry best practices for the process type
229
+ - Common exceptions and error scenarios
230
+
231
+ ### Step 4: Generate PDD Document
232
+
233
+ Use the **Word Architect** doc-gen API to create the PDD.
234
+
235
+ **MANDATORY READS before generating:**
236
+ 1. **`layouts/pdd-template.md`** for the complete PDD section structure, content rules, and page budget
237
+ 2. **`word-architect/generation.md`** for the doc-gen workflow and block types
238
+
239
+ **Template support:**
240
+ - If no template provided, use `"theme": "consulting"` as default
241
+ - If the user provides a `.docx` template file, follow **Custom Template Mode** below
242
+
243
+ #### Custom Template Mode
244
+
245
+ When the user provides their own `.docx` PDD template (e.g., a corporate template, a compliance-mandated format), the generator will automatically extract its styling (fonts, colors, heading sizes, spacing, margins, headers/footers) and apply it to the generated content.
246
+
247
+ **Detection phrases:** "use this template", "follow this format", "use our corporate template", "based on this document", "make it look like this"
248
+
249
+ **Step T1: Get the template path**
250
+
251
+ Ask for the path to the `.docx` template file, or use `file_discovery` if the user gives a partial name.
252
+
253
+ **Step T2: Analyze the template structure**
254
+
255
+ Before generating, open the template to understand its existing section structure:
256
+
257
+ ```
258
+ ExecuteSkillApi:
259
+ endpoint: "/word/open-attach"
260
+ body: { "filePath": "{templatePath}" }
261
+ toolName: "Open Template"
262
+ description: "Opening user template to analyze structure"
263
+ ```
264
+
265
+ Then read its structure:
266
+
267
+ ```
268
+ ExecuteSkillApi:
269
+ endpoint: "/word/get/document-structure"
270
+ body: { "filePath": "{templatePath}" }
271
+ toolName: "Get Template Structure"
272
+ description: "Analyzing template headings and sections"
273
+ ```
274
+
275
+ This reveals the template's existing PDD sections. Compare them against the MANDATORY SECTION CHECKLIST:
276
+ - If the template already has section headings that map to PDD sections (e.g., "Process Overview", "Applications"), follow the template's naming and numbering exactly
277
+ - If the template uses different section names, map them to the closest PDD section (e.g., "Current State" -> "AS IS Process Description")
278
+ - If the template is missing PDD sections, add them using the template's heading style (read formatting with `/word/get/textformatting`)
279
+ - If the template has extra sections not in the PDD layout, keep them and populate where possible
280
+
281
+ **Step T3: Generate with templatePath**
282
+
283
+ Pass `templatePath` instead of `theme` in the doc-gen options. Do NOT set both.
284
+
285
+ ```json
286
+ {
287
+ "operations": [{
288
+ "endpoint": "/doc-gen/start",
289
+ "body": {
290
+ "options": {
291
+ "title": "Process Definition Document",
292
+ "author": "<user or organization>",
293
+ "templatePath": "{path-to-user-template.docx}",
294
+ "outputPath": "<output-path>/PDD_<ProcessName>.docx",
295
+ "pageSize": "LETTER",
296
+ "headerFooter": {
297
+ "header": { "text": "Process Definition Document", "alignment": "right" },
298
+ "footer": { "text": "Confidential", "alignment": "center", "includePageNumber": true }
299
+ }
300
+ }
301
+ }
302
+ }],
303
+ "toolName": "Generate PDD",
304
+ "description": "Starting PDD from template"
305
+ }
306
+ ```
307
+
308
+ **Notes:**
309
+ - `templatePath` overrides `theme`. The generator extracts the template's fonts, colors, sizes, spacing, margins, page setup, and headers/footers automatically
310
+ - User-specified options (margins, headerFooter) take priority over template-extracted values
311
+ - If the template has headers/footers you want to keep, omit the `headerFooter` option to preserve the template's originals
312
+ - Works with both single-call (`/doc-gen/generate`) and multi-turn (`/doc-gen/start`) flows
313
+ - After generation, verify the output matches the template's visual style using `/word/open-attach` + visual inspection
314
+
315
+ **MANDATORY SECTION CHECKLIST** - every PDD MUST include ALL of these sections in this exact order and numbering. DO NOT skip any. DO NOT renumber. For sections where information is unknown, include the section with `[TBD - To be confirmed with <role>]` placeholders. An empty section with TBD is ALWAYS better than omitting the section.
316
+
317
+ ```
318
+ Cover Page
319
+ - Title: "Process Definition Document"
320
+ - Subtitle: <Process Name>
321
+ - Author, Date
322
+ - Version (REQUIRED, e.g., "1.0")
323
+ - Status (REQUIRED, one of: Draft / Under Review / Approved)
324
+
325
+ 1. Introduction
326
+ 1.1 Purpose [standard text from layout]
327
+ 1.2 Objectives [table, min 3 rows]
328
+ 1.3 Process Key Contacts [table, use [TBD] rows if unknown]
329
+ 1.4 Version History [table, at least the initial row]
330
+ 1.5 Approvers [table, use [TBD] rows if unknown]
331
+ 1.6 Prerequisites [bullet list, use [TBD] if unknown]
332
+
333
+ 2. AS IS Process Description
334
+ 2.1 Process Overview
335
+ 2.2 Applications Used [table with ALL columns: App, Version, Access, Auth, Permissions]
336
+ 2.3 High-Level AS IS Process Map [numbered list]
337
+ 2.4 Detailed Step-by-Step Description
338
+ [If activity count > 10, minimum ceil(count/3) step subsections.
339
+ Each sub-workflow (InvokeWorkflowFile) gets its own subsection.]
340
+ 2.5 Process Flow Diagram [reference to diagram OR textual flow description]
341
+ 2.6 Business Rules and Logic [table with verbatim expressions]
342
+ 2.7 Input and Output Data [two tables: Input + Output]
343
+
344
+ 3. TO BE Process Description
345
+ 3.1 In Scope of RPA
346
+ 3.2 Out of Scope of RPA
347
+ 3.3 TO BE Process Map [proposed automated flow]
348
+ 3.4 Parallel Initiatives [use [TBD] if unknown]
349
+ 3.5 Exception Handling [Business exceptions table + App exceptions table]
350
+ 3.6 Expected Benefits [REQUIRED comparison table: Manual vs Automated]
351
+
352
+ 4. Other
353
+ 4.1 Risks and Assumptions [MUST include unused variables and missing TryCatch as risks when applicable]
354
+ 4.2 Dependencies [use [TBD] if unknown]
355
+ 4.3 Reporting [KPIs, use [TBD] if unknown]
356
+ 4.4 Other Observations
357
+
358
+ Appendix
359
+ A. Glossary [REQUIRED: UiPath terms, RPA terms]
360
+ B. Screenshots [if provided, else omit]
361
+ C. Variable and Argument Reference [REQUIRED: two tables, arguments + internal variables]
362
+ D. State Diagram [REQUIRED for State Machine workflows, else omit]
363
+ E. Call Hierarchy [REQUIRED if workflow uses InvokeWorkflowFile]
364
+ ```
365
+
366
+ **Before calling `/doc-gen/finish`**, self-audit: go through the checklist above and verify every section is present. If a section is missing, add it (with TBD content if needed) before finishing.
367
+
368
+ Use multi-turn generation (`/doc-gen/start` -> `/doc-gen/add-content` -> `/doc-gen/finish`) since PDDs typically exceed 25 blocks.
369
+
370
+ **Options:**
371
+ ```json
372
+ {
373
+ "operations": [{
374
+ "endpoint": "/doc-gen/start",
375
+ "body": {
376
+ "options": {
377
+ "title": "Process Definition Document",
378
+ "author": "<user or organization>",
379
+ "theme": "consulting",
380
+ "outputPath": "<user's preferred path or Desktop>/PDD_<ProcessName>.docx",
381
+ "pageSize": "LETTER",
382
+ "headerFooter": {
383
+ "header": { "text": "Process Definition Document", "alignment": "right" },
384
+ "footer": { "text": "Confidential", "alignment": "center", "includePageNumber": true }
385
+ }
386
+ }
387
+ }
388
+ }],
389
+ "toolName": "Generate PDD",
390
+ "description": "Starting PDD with consulting theme"
391
+ }
392
+ ```
393
+
394
+ ### Step 5: Verify and Polish
395
+
396
+ 1. Open the generated document with `/word/open-attach`
397
+ 2. Update TOC with `/word/update/toc` using `{ "action": "update" }` (this refreshes the existing TOC; omitting the action on macOS inserts a new TOC instead of updating)
398
+ 3. Check structure with `/word/get/document-structure`
399
+ 4. **Structural audit** - verify the document heading list matches the MANDATORY SECTION CHECKLIST above exactly:
400
+ - Every numbered section (1.1 through 4.4) is present
401
+ - Section numbers are sequential (no gaps like 2.4 -> 2.6)
402
+ - Appendix entries A, C, and (if applicable) D, E are present
403
+ - Cover page has Version AND Status
404
+ 5. If any section is missing, use `/word/insert/html` to add it with TBD placeholders (do NOT skip)
405
+ 6. If numbering is wrong, use `/word/find/text` + `/word/replace/text` to fix section numbers
406
+ 7. Verify extraction completeness:
407
+ - Every unused variable is listed as a risk in Section 4.1
408
+ - Every sub-workflow has an entry in Appendix E
409
+ - Activity count -> detailed step count ratio is reasonable (at least 1 step per 3 activities)
410
+ 8. Fix remaining issues using `/word/*` APIs
411
+ 9. Save with `/word/save` — the updated TOC and fixes are lost otherwise
412
+ 10. Report the result to the user with a self-audit summary:
413
+ - Total sections produced
414
+ - Any TBD items that need stakeholder input
415
+ - Any risks auto-flagged from workflow analysis
416
+
417
+ ---
418
+
419
+ ## Adaptation Rules
420
+
421
+ The MANDATORY SECTION CHECKLIST in Step 4 is the single source of truth for document structure (sections 1.1 through 4.4 + Appendix A-E). The detailed content guidance for each section is in `layouts/pdd-template.md`. These adaptation rules control **content depth**, not structure.
422
+
423
+ - **From .xaml**: Sections 2.4, 2.6, and 3.5 should be highly detailed based on workflow analysis. Section 3.1/3.2 can reference the existing automation. For State Machine workflows, organize Section 2.4 by state (one subsection per state with entry actions and transitions). Include transition condition expressions verbatim in Section 2.6.
424
+ - **From Orchestrator**: Same as .xaml, but also include: package version, feed ID, and deployment folder in Section 2.1 (Process Overview). If multi-file process, document the call hierarchy (Main.xaml -> sub-workflows) in Appendix E and dependencies from project.json in Section 2.2 (Applications Used). Add Orchestrator-specific prerequisites in Section 1.6 (folder permissions, robot type, machine requirements).
425
+ - **Missing info**: Mark gaps with `[TBD - To be confirmed with <stakeholder>]` rather than inventing data.
426
+ - **Short processes** (<10 steps): Keep all required sections and numbering intact. Use concise content (1-2 sentences per subsection, single-row tables where applicable). For Section 2.6, inline business rules into Section 2.4 step tables but still include Section 2.6 as a summary table. Never omit appendix entries marked REQUIRED in the checklist (A, C, and E if sub-workflows exist).
427
+ - **Complex processes** (>30 steps): Break Section 2.4 into sub-processes with their own detailed step subsections.
428
+
429
+ ## Keywords
430
+ .xaml, xaml workflow, UiPath workflow, Orchestrator process, deployed process, reverse-engineer workflow, document existing automation, workflow documentation