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