@uipath/delegate-sdk 1.203.1 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,387 @@
1
+ # Recipe: Troubleshooting Common Issues
2
+
3
+ ## When to Use
4
+ Use this guide when Jira API calls fail or behave unexpectedly.
5
+
6
+ ---
7
+
8
+ ## Diagnostic Workflow
9
+
10
+ ### Step 1: Check Connection Health
11
+
12
+ **Symptom:** Any API call fails with 401 or connection errors
13
+
14
+ ```json
15
+ {
16
+ "method": "GET",
17
+ "url": "/api/v1/Connections/{connection_id}/ping",
18
+ }
19
+ ```
20
+
21
+ **Expected Response:**
22
+ ```json
23
+ {
24
+ "isHealthy": true,
25
+ "message": "Connection is healthy"
26
+ }
27
+ ```
28
+
29
+ **Troubleshooting:**
30
+ - `isHealthy: false` → Connection expired, user needs to re-authorize in UiPath Cloud
31
+ - `404 Not Found` → Connection ID is invalid or deleted
32
+ - `403 Forbidden` → User lacks permission to check connection
33
+
34
+ ---
35
+
36
+ ### Step 2: Verify User Permissions
37
+
38
+ **Symptom:** 403 Forbidden on specific operations
39
+
40
+ ```json
41
+ {
42
+ "method": "GET",
43
+ "url": "/myself",
44
+ "path": "/myself"
45
+ }
46
+ ```
47
+
48
+ This returns the current user's info. Then check their project permissions:
49
+
50
+ ```json
51
+ {
52
+ "method": "GET",
53
+ "url": "/user/permission/search",
54
+ "query": {
55
+ "permissions": "CREATE_ISSUES,EDIT_ISSUES,DELETE_ISSUES",
56
+ "projectKey": "PROJ"
57
+ }
58
+ }
59
+ ```
60
+
61
+ **Permissions Required:**
62
+ - View issues: `BROWSE_PROJECTS`
63
+ - Create issues: `CREATE_ISSUES`
64
+ - Edit issues: `EDIT_ISSUES`
65
+ - Delete issues: `DELETE_ISSUES`
66
+ - Add comments: `ADD_COMMENTS`
67
+ - Transition issues: `TRANSITION_ISSUES`
68
+
69
+ ---
70
+
71
+ ### Step 3: Validate Project Access
72
+
73
+ **Symptom:** 404 on project operations or issues
74
+
75
+ ```json
76
+ {
77
+ "method": "GET",
78
+ "url": "/project",
79
+ "path": "/project"
80
+ }
81
+ ```
82
+
83
+ This lists all projects the user can access. If the target project is missing:
84
+ - Project doesn't exist
85
+ - User has no access
86
+ - Project key is incorrect (case-sensitive)
87
+
88
+ ---
89
+
90
+ ### Step 4: Test with Simple Request
91
+
92
+ **Symptom:** Complex request fails, need to isolate the problem
93
+
94
+ Start with the simplest possible request:
95
+
96
+ ```json
97
+ {
98
+ "method": "GET",
99
+ "url": "/serverInfo",
100
+ "path": "/serverInfo"
101
+ }
102
+ ```
103
+
104
+ If this works, the connection and auth are fine. Problem is in request format.
105
+
106
+ ---
107
+
108
+ ## Common Error Patterns
109
+
110
+ ### Pattern 0: 200 OK with 401 Error in Body (MOST COMMON)
111
+
112
+ **Symptom:** Request returns 200 OK status but response body contains 401 Unauthorized error
113
+
114
+ **Cause:** Wrong URL path in request body - usually includes `/rest/api/3` when using UiPath connector
115
+
116
+ **Solution:**
117
+ 1. **Check URL in request body** - Should be `/project`, NOT `/rest/api/3/project`
118
+ 2. **UiPath connector rule:** OMIT `/rest/api/3` prefix - Integration Service adds it automatically
119
+ 3. **Direct API fallback rule:** USE `/rest/api/3` prefix
120
+ 4. **Verify endpoint:** Ensure using `/search/jql` not `/search`
121
+ 5. **Try again** with corrected URL
122
+
123
+ **Example of WRONG URL:**
124
+ ```json
125
+ {
126
+ "url": "/rest/api/3/project" // ❌ WRONG for UiPath connector
127
+ }
128
+ ```
129
+
130
+ **Example of CORRECT URL:**
131
+ ```json
132
+ {
133
+ "url": "/project" // ✅ CORRECT for UiPath connector
134
+ }
135
+ ```
136
+
137
+ ---
138
+
139
+ ### Pattern 1: "Field 'X' cannot be set" (400)
140
+
141
+ **Cause:** Trying to set a field that's not editable for this issue type or workflow state
142
+
143
+ **Solution:**
144
+ 1. Fetch create metadata to see which fields are available:
145
+ ```json
146
+ {
147
+ "method": "GET",
148
+ "url": "/issue/createmeta",
149
+ "query": {
150
+ "projectKeys": "PROJ",
151
+ "expand": "projects.issuetypes.fields"
152
+ }
153
+ }
154
+ ```
155
+
156
+ 2. Check `fields[fieldKey].operations` to see if field is settable
157
+
158
+ ---
159
+
160
+ ### Pattern 2: "Issue does not exist" (404)
161
+
162
+ **Cause:** Issue key is wrong or deleted
163
+
164
+ **Solution:**
165
+ 1. Verify issue key format: `PROJ-123` (project key must match exactly)
166
+ 2. Check if issue was deleted (search recently deleted):
167
+ ```json
168
+ {
169
+ "method": "GET",
170
+ "url": "/search/jql",
171
+ "query": {
172
+ "jql": "key = 'PROJ-123'"
173
+ }
174
+ }
175
+ ```
176
+
177
+ ---
178
+
179
+ ### Pattern 3: "JQL Query Error" (400)
180
+
181
+ **Cause:** Invalid JQL syntax
182
+
183
+ **Common JQL Mistakes:**
184
+ | Mistake | Correct |
185
+ |---------|---------|
186
+ | `status = In Progress` | `status = 'In Progress'` (quote values with spaces) |
187
+ | `assignee = john@example.com` | `assignee = currentUser()` or get accountId first |
188
+ | `created = 2024-01-01` | `created >= 2024-01-01` (use operators) |
189
+ | `priority = 1` | `priority = High` (use name, not ID) |
190
+
191
+ **Solution:**
192
+ 1. Use JQL validator:
193
+ ```json
194
+ {
195
+ "method": "POST",
196
+ "url": "/jql/parse",
197
+ "body": "{\"queries\": [\"project = PROJ AND status = 'In Progress'\"]}"
198
+ }
199
+ ```
200
+
201
+ 2. **📖 Refer to official JQL reference:** [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search) for complete syntax guide
202
+
203
+ ---
204
+
205
+ ### Pattern 4: "Transition not valid" (400)
206
+
207
+ **Cause:** Trying to transition to a state that's not allowed from current state
208
+
209
+ **Solution:**
210
+ 1. Get available transitions for this issue:
211
+ ```json
212
+ {
213
+ "method": "GET",
214
+ "url": "/issue/{issueKey}/transitions",
215
+ "path": "/issue/{issueKey}/transitions"
216
+ }
217
+ ```
218
+
219
+ 2. Only use transition IDs returned by this endpoint
220
+ 3. Workflow may have conditions (assignee, resolution, etc.)
221
+
222
+ ---
223
+
224
+ ### Pattern 5: Rate Limit (429)
225
+
226
+ **Symptom:**
227
+ ```json
228
+ {
229
+ "statusCode": 429,
230
+ "message": "Rate limit exceeded"
231
+ }
232
+ ```
233
+
234
+ **Solution:**
235
+ 1. Check `Retry-After` header (seconds to wait)
236
+ 2. Implement exponential backoff
237
+ 3. Reduce request frequency
238
+ 4. Use field filtering to reduce response size
239
+
240
+ **Rate Limit Headers:**
241
+ - `X-RateLimit-Limit`: Total allowed per time window
242
+ - `X-RateLimit-Remaining`: Requests remaining
243
+ - `X-RateLimit-Reset`: Unix timestamp when limit resets
244
+ - `Retry-After`: Seconds to wait before retrying
245
+
246
+ ---
247
+
248
+ ### Pattern 6: "ADF validation error" or "Operation value must be a string" (400) ⚠️ VERY COMMON
249
+
250
+ **Symptom:**
251
+ ```json
252
+ {
253
+ "errors": { "description": "Operation value must be a string" }
254
+ }
255
+ ```
256
+ or
257
+ ```json
258
+ {
259
+ "errors": { "body": "Operation value must be a string" }
260
+ }
261
+ ```
262
+
263
+ **Cause:** The UiPath IS connector uses **Jira API v2**, where `description` and comment `body` are **plain strings** — NOT Atlassian Document Format (ADF) objects. Passing an ADF object causes this error.
264
+
265
+ **❌ WRONG — ADF object:**
266
+ ```json
267
+ {
268
+ "body": "{\"fields\": {\"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}}"
269
+ }
270
+ ```
271
+
272
+ **✅ CORRECT — Plain string with `\n` for newlines:**
273
+ ```json
274
+ {
275
+ "body": "{\"fields\": {\"description\": \"First paragraph.\\n\\n- Bullet one\\n- Bullet two\"}}"
276
+ }
277
+ ```
278
+
279
+ **Plain text formatting (API v2 wiki markup):**
280
+ - Paragraph break: `\n\n`
281
+ - Bullet item: `- item`
282
+ - Bold: `*text*`
283
+ - Code: `{{text}}`
284
+ - Heading: `h1. Title`
285
+
286
+ **Note:** ADF is only supported when calling the **direct Jira REST API v3** — not via the UiPath IS connector.
287
+
288
+ ---
289
+
290
+ ## Debugging Checklist
291
+
292
+ When a Jira operation fails, check these in order:
293
+
294
+ - [ ] **⚠️ URL path** - OMIT `/rest/api/3` when using UiPath connector (most common issue!)
295
+ - [ ] **200 OK with 401 error** - Check if response body has error despite 200 status
296
+ - [ ] **Connection health** - Ping endpoint returns healthy
297
+ - [ ] **Connection state** - State is "Enabled", not "Expired" or "Disabled"
298
+ - [ ] **User permissions** - User has required permission for operation
299
+ - [ ] **Project access** - User can see the project in project list
300
+ - [ ] **Project key case** - Project key is uppercase and exact match
301
+ - [ ] **Issue key format** - Format is `PROJECTKEY-123`
302
+ - [ ] **JQL syntax** - Values with spaces are quoted
303
+ - [ ] **Query params are strings** - `{"maxResults": "50"}` not `{"maxResults": 50}`
304
+ - [ ] **Body is escaped JSON** - For POST/PUT, body is a JSON string
305
+ - [ ] **Description/comment are plain strings** - Use `"description": "text with \\n"` NOT ADF objects — see Pattern 6
306
+ - [ ] **Required fields** - All required fields for issue type are present
307
+ - [ ] **Required fields** - All required fields for issue type are present
308
+ - [ ] **Field types** - Field values match expected types (string, number, object)
309
+ - [ ] **Workflow transitions** - Transition ID is valid for current state
310
+
311
+ ---
312
+
313
+ ## Performance Debugging
314
+
315
+ ### Slow Response Times
316
+
317
+ **Symptoms:** Requests take >5 seconds
318
+
319
+ **Diagnostics:**
320
+ 1. Check if fetching too many results: Use `maxResults` to limit
321
+ 2. Check if requesting all fields: Use `fields` parameter to filter
322
+ 3. Check if JQL is inefficient: Add indexed field filters (project, status, assignee)
323
+
324
+ **Optimizations:**
325
+
326
+ **Slow approach:**
327
+ - Fetching all fields for 1000 issues
328
+ - Using only full-text search without indexed filters
329
+
330
+ **Fast approach:**
331
+ - Limit to 50 issues with `maxResults: "50"`
332
+ - Use indexed field filters (`project`, `status`) before full-text search
333
+ - Request only specific fields: `fields: "key,summary,status"`
334
+
335
+ ---
336
+
337
+ ## Response Validation Helpers
338
+
339
+ ### Check Response Structure
340
+
341
+ **Validation checklist:**
342
+ 1. **Status code:** Must be 200-299, else error with `response.statusCode` and `response.body.message`
343
+ 2. **Error messages:** Check `response.body.errorMessages` array, join with commas if present
344
+ 3. **Field errors:** Check `response.body.errors` object, format as `field: error` for each entry
345
+ 4. **Warnings (non-fatal):** Check `response.body.warningMessages` array, log warnings but don't fail
346
+ 5. **Return null if valid**
347
+
348
+ ---
349
+
350
+ ## Emergency Recovery
351
+
352
+ ### Connection Lost During Operation
353
+
354
+ If connection fails mid-operation:
355
+
356
+ 1. **Check if operation completed:**
357
+ - For create: Search for recently created issues
358
+ - For update: Fetch issue and check if changes applied
359
+ - For delete: Try to fetch the issue (404 means deleted)
360
+
361
+ 2. **Don't retry blindly:**
362
+ - Creates might duplicate issues
363
+ - Updates might apply twice
364
+ - Always verify state before retrying
365
+
366
+ 3. **Idempotent operations are safe:**
367
+ - GET requests can always be retried
368
+ - PUT with same data can be retried
369
+ - POST (create) should NOT be retried without verification
370
+
371
+ ---
372
+
373
+ ## Key Learnings
374
+
375
+ 1. **⚠️ MOST IMPORTANT: URL paths** - OMIT `/rest/api/3` when using UiPath connector, include it for direct API
376
+ 2. **⚠️ DESCRIPTION/COMMENT ARE PLAIN STRINGS** - The IS connector uses Jira API v2. `description` and comment `body` are plain strings with `\n` for newlines — NOT ADF objects. Passing ADF objects causes `"Operation value must be a string"` (400).
377
+ 3. **200 OK doesn't mean success** - Check response body for errors even with 200 status
378
+ 3. **Always check connection health first** - Saves time debugging auth issues
379
+ 4. **Validate permissions before operations** - Avoids confusing 403 errors
380
+ 5. **Test with simple requests** - Isolates problems to request format vs. auth/connection
381
+ 6. **Use metadata endpoints** - Discover what's possible before attempting operations
382
+ 7. **Check response structure** - Jira returns detailed error info in `errorMessages` and `errors`
383
+ 8. **Monitor rate limits** - Check headers to avoid hitting limits
384
+ 9. **Don't retry creates blindly** - Verify operation completed before retrying
385
+ 10. **Use JQL validator** - Catch syntax errors before executing search
386
+ 11. **Keep project keys exact** - Case-sensitive and must match exactly
387
+ 12. **ADF structure is strict** - Must have `type`, `version`, and `content` with proper nesting
@@ -0,0 +1,289 @@
1
+ ---
2
+ name: knowledge-base
3
+ friendly_name: Knowledge Base
4
+ version: 2.2.0
5
+ description: "Build and maintain a persistent, OKF-compliant markdown knowledge base. Ingest sources, compile interlinked concept pages with YAML frontmatter, query accumulated knowledge, and lint for consistency. Trigger when the user mentions building a knowledge base, wiki, research compilation, or organizing information from multiple sources into a structured reference."
6
+ icon: book
7
+ color: 8B5CF6
8
+ tags: [research, knowledge-base, okf, wiki]
9
+ ---
10
+
11
+ # Knowledge Base
12
+
13
+ Build and maintain a persistent, compounding knowledge base as interlinked markdown files in the **Open Knowledge Format (OKF)**.
14
+
15
+ The human curates sources and directs analysis. You summarize, cross-reference, file, and maintain consistency. The knowledge base is yours to write and maintain. The user reads it, queries it, and guides what goes in.
16
+
17
+ ## Format: OKF
18
+
19
+ The knowledge base is an OKF bundle — a directory tree of markdown files, each with YAML frontmatter. Two rules make it conformant:
20
+
21
+ 1. Every concept file has frontmatter with a non-empty `type`.
22
+ 2. Relationships are **standard markdown links in the prose** — there is no separate graph file. The graph view is derived from these links, so link liberally.
23
+
24
+ `index.md`, `log.md`, and `stakeholders.md` are reserved filenames (see below); every other `.md` is a concept.
25
+
26
+ ## Knowledge Base Location
27
+
28
+ **Path:** `{WikiPath}`
29
+
30
+ Use the path above for all operations. Do not compute or guess the path.
31
+
32
+ ## First Read: Classify Wiki State
33
+
34
+ On the first knowledge-base operation in a session, read the contents of `{WikiPath}/index.md`. Classify from content, not from file or directory existence:
35
+
36
+ - Missing or blank `index.md` means the knowledge base is uninitialized.
37
+ - An `index.md` containing the host placeholder `Empty. No sources ingested yet.` is a scaffold, not an initialized knowledge base. Run Initialization, replace the placeholder index, and create `log.md` if it is missing.
38
+ - Any other `index.md` is initialized. Resume from it.
39
+
40
+ An initialized `index.md` may carry `language:` in its frontmatter — the language this knowledge base is written in. Read it and keep writing in it; never re-ask, and never switch language because a later turn arrives in a different one.
41
+
42
+ Do not treat `WikiPath`, a wiki directory, a non-empty file, or a host-provided `hasWiki` signal as proof of initialization. After initializing a missing, blank, or scaffolded wiki, re-read `index.md` and verify that the placeholder is gone and `log.md` exists before writing concept pages.
43
+
44
+ ## Initialization
45
+
46
+ When starting a new knowledge base:
47
+
48
+ 1. Determine the domain from the user request, project context, or calling skill. Ask the user only when it cannot be inferred (e.g. "AI research", "competitive analysis", "project documentation").
49
+ 2. Confirm the knowledge base language, before creating any file. Skip when `UserUiLanguage` is English (`en`, `en-*`) **and** the user has been writing to you in English. Otherwise ask once through one `AskUser` — batched with the domain question when you need that too:
50
+ - `English (Recommended)` — keeps the knowledge base reusable across teams
51
+ - the `UserUiLanguage` language, native name
52
+ - `{"kind":"userinput"}` for any other language
53
+
54
+ Record the answer as `language: <BCP-47 code>` in `index.md` frontmatter and never ask again; later sessions and other skills read it from there. Page prose, titles and `description` follow it. Structure stays English regardless: frontmatter field names, `type` values, reserved filenames, folder and file slugs, link targets.
55
+ 3. Create the directory with this structure:
56
+
57
+ ```
58
+ {WikiPath}/
59
+ ├── index.md # Reserved. Directory listing for progressive disclosure.
60
+ ├── log.md # Reserved. Chronological update history.
61
+ ├── raw/ # Immutable source material (the primary research corpus).
62
+ ├── <category-a>/ # Top-level category folder. Folder name = graph color group.
63
+ │ ├── page.md # Concept pages directly under the category.
64
+ │ └── <kind>/ # Subfolders allowed at any depth; the L2 subfolder
65
+ │ └── ... # (`<kind>/`) sets the graph color for everything below it.
66
+ └── <category-b>/
67
+ └── ...
68
+ ```
69
+
70
+ `raw/` is the only reserved folder. Every other top-level folder is a free-form category root: pick names that cluster this domain's entities (e.g. `anthropic/`, `methodologies/`, `treaties/`).
71
+
72
+ 4. Create `index.md` (frontmatter carries only the optional OKF version marker and `language`):
73
+
74
+ ```markdown
75
+ # Knowledge Base — {domain}
76
+
77
+ > Content catalog. Read this first to find relevant pages for any query.
78
+
79
+ # Pages
80
+
81
+ * [Page Title](/category/page.md) - one-line summary
82
+ ```
83
+
84
+ 5. Create `log.md`:
85
+
86
+ ```markdown
87
+ # Update Log
88
+
89
+ ## YYYY-MM-DD
90
+ * **Initialization**: Created knowledge base for {domain}.
91
+ ```
92
+
93
+ 6. Create `raw/` plus one or more top-level category folders that fit the domain. Add categories later by creating folders.
94
+ 7. Confirm ready and explain the three operations: ingest, query, lint.
95
+
96
+ ## Resuming an Existing Knowledge Base
97
+
98
+ Resume only when `index.md` is initialized according to First Read. Read it to orient, then proceed with the requested operation (ingest, query, lint). A host scaffold containing `Empty. No sources ingested yet.` must go through Initialization even though the file exists and is non-empty.
99
+
100
+ ## Operations
101
+
102
+ ### 1. Ingest
103
+
104
+ When the user provides sources (URLs, files, pasted text) or asks you to research a topic:
105
+
106
+ **Capture raw sources:**
107
+ - Copy external files into `raw/` first. The bundle must be self-contained.
108
+ - Save each source to `raw/` with a descriptive filename (e.g. `raw/karpathy-on-llms.md`) and minimal frontmatter so the source is itself a conformant concept:
109
+
110
+ ```markdown
111
+ ---
112
+ type: Source
113
+ resource: https://example.com/original-url
114
+ timestamp: 2026-06-16T00:00:00Z
115
+ ---
116
+
117
+ (full extracted content)
118
+ ```
119
+
120
+ - For URLs: extract the content and save the markdown to `raw/`.
121
+ - If delegating research to an agent, instruct it to: cite full URLs, return complete extracted content (not summaries), use clear headings, separate distinct sources. Save each returned source to `raw/` as a separate file.
122
+
123
+ **Process one source at a time (do NOT read multiple sources in parallel):**
124
+ - Read ONE raw source, fully process it (fan out into multiple concept pages), then move to the next. Reading 2+ sources per turn overwhelms context and collapses into 1:1 source-to-page mapping.
125
+ - For each source:
126
+ 1. Read the source (one file only).
127
+ 2. Identify every distinct subject it covers.
128
+ 3. For each subject: create or update a concept page under the best category folder (see placement rules).
129
+ 4. Also update existing pages the source adds to — don't only create new pages.
130
+ 5. Update `index.md` with new/changed pages.
131
+ 6. Drop the source from working memory; move to the next.
132
+ - Between sources, re-read `index.md` to reorient. Don't rely on memory.
133
+
134
+ **Write concept pages:**
135
+ - **One source often spawns many pages.** Each distinct subject gets its own page. Fan out: a company report might spawn pages for the CEO, each product line, the market.
136
+ - Frontmatter on every page: `type` (required), `title`, `description` (one line — this is the page's summary in the index and UI), `tags`, `generated: { by, at }` (who wrote it, when — see Trust signals).
137
+ - Provenance lives in frontmatter `sources` (OKF v0.2 — supersedes the old `# Citations` body section). Every entry needs a **specific locator** in `title`, not just a filename:
138
+ ```yaml
139
+ sources:
140
+ - resource: /raw/article.md
141
+ id: article-heading
142
+ title: Article — "Heading Title"
143
+ - resource: /raw/paper.md
144
+ title: Paper p.3, Table 1
145
+ ```
146
+ A bare `resource` with no section/locator in `title` is not enough. Give an `id` when body claims need per-claim attribution.
147
+ - Cross-link related pages with standard markdown links, bundle-root-relative: `[Claude](/anthropic/claude.md)`. The graph is built from these links.
148
+ - Every page links to at least 2 others. No exceptions — if you can't find 2 connections, the page is too narrow; merge it.
149
+ - **To merge a narrow page:** move its content into the broader page, delete the narrow file, remove its `index.md` entry, and repoint any links that targeted it.
150
+
151
+ **Final pass (after all sources — do NOT skip):**
152
+ 1. Re-read `index.md` for the full picture.
153
+ 2. Fix early pages: pages from the first source often lack links to pages that didn't exist yet. Add them.
154
+ 3. Scan for missing cross-references between pages that should link.
155
+ 4. Check gaps: topics mentioned across multiple pages that deserve their own page.
156
+ 5. Update stale `index.md` summaries.
157
+ 6. Append one summary entry to `log.md` covering the full ingest.
158
+
159
+ **Report what changed:** list every file created or updated. One source touching many pages is normal and desired.
160
+
161
+ ### 2. Query
162
+
163
+ When the user asks a question against the knowledge base:
164
+
165
+ 1. Read `index.md` to find relevant pages.
166
+ 2. Read only the 2-3 most relevant pages. Do not load the whole base.
167
+ 3. Follow links for connected information.
168
+ 4. Synthesize an answer, citing pages.
169
+ 5. If the answer is substantial (a comparison, deep dive, novel connection), offer to file it as a new page so it compounds.
170
+ 6. Append to `log.md`: `* **Query**: {question summary}` under today's date.
171
+
172
+ ### 3. Lint
173
+
174
+ When the user asks to health-check, lint, or audit:
175
+
176
+ 1. **Orphans**: pages no other page links to.
177
+ 2. **Contradictions**: conflicting claims across pages on overlapping topics.
178
+ 3. **Stale content**: pages not updated despite newer sources on the same topic.
179
+ 4. **Gaps**: subjects linked to but with no page yet (broken links — OKF tolerates these as not-yet-written knowledge).
180
+ 5. **Index completeness**: every page appears in `index.md`.
181
+ 6. **Frontmatter**: every concept has a non-empty `type`, a one-line `description`, and `generated: { by, at }`.
182
+ 7. **Source coverage**: raw sources not yet integrated into pages.
183
+ 8. **Weak sources**: `sources` entries with a bare `resource` (no locator in `title`), or claims with no source at all.
184
+ 9. **Staleness**: pages whose `stale_after` date has passed, or `status: deprecated` pages still heavily linked.
185
+ 10. **Oversized pages**: pages over 1,000 words that should split.
186
+ 11. Report findings with file paths and suggested actions.
187
+ 12. Append to `log.md`: `* **Lint**: {N} issues found` under today's date.
188
+
189
+ ## Concept Page Frontmatter (OKF v0.2)
190
+
191
+ ```markdown
192
+ ---
193
+ type: Concept # REQUIRED. Free-form (Concept, Person, Product, Metric, Playbook, ...).
194
+ title: Claude # Human-readable display name.
195
+ description: Anthropic's flagship assistant family. # One line — the page summary.
196
+ tags: [anthropic, llm]
197
+ generated: # Who produced this page, when (supersedes v0.1 `timestamp`).
198
+ by: knowledge-base/1.1
199
+ at: 2026-08-11T09:00:00Z
200
+ verified: # Optional confirmation events. Only human:<id> makes it human-reviewed.
201
+ - by: human:jane.doe
202
+ at: 2026-08-11
203
+ status: stable # Optional: draft | stable | deprecated.
204
+ stale_after: 2027-02-01 # Optional: date after which the page needs re-checking.
205
+ sources: # Provenance (supersedes the v0.1 `# Citations` body section).
206
+ - resource: /raw/claude-model-card.md
207
+ title: Model card — "Training"
208
+ ---
209
+
210
+ # Claude
211
+
212
+ Anthropic's assistant family, trained with [RLHF](/methodologies/rlhf.md) and
213
+ positioned against [GPT-4](/openai/gpt-4.md).
214
+ ```
215
+
216
+ ## Trust Signals (OKF v0.2)
217
+
218
+ Trust tiers are DERIVED by consumers, never stored: no `verified` → *unverified*; verified only by non-human actors → *machine-confirmed*; any `human:<id>` verifier → *human-reviewed*. The Delegate UI shows these tiers in the file explorer and on case-diagram attachment chips.
219
+
220
+ Actor convention: `<producer>/<version>` for agents and tools (write `by: knowledge-base/<this skill's version>` for pages you author), `human:<id>` for people, `process:<id>` for automation.
221
+
222
+ - Write `generated: { by, at }` on every page you create or substantially rewrite.
223
+ - Never write `verified` entries with a `human:` actor yourself. Add a `human:<id>` verification only when the user explicitly confirms the page's content — record their id, not yours.
224
+ - You may add a machine verification (`by: knowledge-base/<version>`) after a lint pass confirms a page against its sources.
225
+ - Migration from v0.1: `timestamp` → `generated.at`; the `# Citations` body section → `sources` frontmatter. Migrate pages opportunistically when you touch them; do not mass-rewrite.
226
+
227
+ ## index.md Format
228
+
229
+ Reserved file. Frontmatter carries only the optional `okf_version: "0.2"` marker and `language` (the BCP-47 code the knowledge base is written in, set at Initialization). One section per group; entries carry the linked page's `description`:
230
+
231
+ ```markdown
232
+ # Pages
233
+
234
+ * [Claude](/anthropic/claude.md) - Anthropic's flagship assistant family.
235
+ * [RLHF](/methodologies/rlhf.md) - Reinforcement learning from human feedback.
236
+ ```
237
+
238
+ ## log.md Format
239
+
240
+ Reserved file. Date-grouped, newest first; the leading bold word is a convention:
241
+
242
+ ```markdown
243
+ # Update Log
244
+
245
+ ## 2026-06-16
246
+ * **Ingest**: Added [Claude](/anthropic/claude.md) and [RLHF](/methodologies/rlhf.md) from the model card.
247
+ * **Creation**: Established the `anthropic/` category.
248
+ ```
249
+
250
+ ## stakeholders.md Format
251
+
252
+ Reserved file. People involved in the project and their roles. The UI renders this file directly as a rail widget — data lives in frontmatter, not prose:
253
+
254
+ ```markdown
255
+ ---
256
+ description: People involved in this project and their roles.
257
+ stakeholders:
258
+ - name: Alex Rivera
259
+ role: Process owner
260
+ group: internal # internal | external
261
+ email: alex.rivera@example.com # optional
262
+ ---
263
+
264
+ Free-form notes about each stakeholder (agent-maintained).
265
+ ```
266
+
267
+ Add or update entries when the user names project people (BA interview, transcript, "the process owner is X"). Missing file: create it with this shape — don't ask the user for permission first.
268
+
269
+ ## Page Guidelines
270
+
271
+ - **Place pages in a top-level category folder; pick a folder name that fits the entity.** `raw/` is reserved for sources. Every other top-level folder is a category root and colors its pages by the folder name in the graph.
272
+ - **Folder names are free-form.** Cluster pages by kind: `anthropic/claude.md`, `openai/gpt-4.md`, `methodologies/rlhf.md`.
273
+ - **Nest as deep as you want.** The **L2 subfolder** (first folder under the top-level category) sets the graph color, so siblings deep in a subtree share a bubble.
274
+ - **Be consistent.** Once a kind of entity lives in a folder, put future ones there. Don't split `people/` and `persons/`.
275
+ - **No loose pages at the root.** Files at the bundle root other than `index.md`, `log.md`, and `stakeholders.md` are ignored.
276
+ - **Filenames**: lowercase, hyphens, no spaces.
277
+ - **Structure**: `# Title` heading, then `##` sections. Provenance lives in frontmatter `sources`, not in the body.
278
+ - **Length**: 500-1,000 words. Split pages over 1,000 words.
279
+ - **Links**: bundle-root-relative `[text](/folder/page.md)`. More links = richer graph.
280
+ - **Portable**: standard markdown links open in any markdown tool or editor.
281
+
282
+ ## Important Rules
283
+
284
+ - **Write to disk, not to memory.** The base on disk is your persistent memory; context is scratchpad.
285
+ - **Never modify files in `raw/`.** Sources are immutable. Corrections go in concept pages.
286
+ - **Always update `index.md` and `log.md`** when making changes.
287
+ - **Copy external sources into `raw/`.** The bundle must be self-contained.
288
+ - **Ask before mass updates.** If an ingest would touch 10+ existing pages, confirm first.
289
+ - **File valuable query answers back in.** Don't let good analysis disappear into chat history.