@uipath/delegate-sdk 1.203.1 → 1.203.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +729 -0
- package/dist/skills/business-analysis/as-is-capture.md +444 -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 +224 -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 +88 -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,348 @@
|
|
|
1
|
+
# Excel Architect — Reference Guide
|
|
2
|
+
|
|
3
|
+
Detailed styling, formatting, and workflow guidance. Load this file when you need paste_content, Big Four styling, pivot tables, keyboard shortcuts, or step-by-step workflows.
|
|
4
|
+
|
|
5
|
+
**Contents:**
|
|
6
|
+
1. paste_content (styled data entry)
|
|
7
|
+
2. Professional styling presets (color coding + 3 visual themes)
|
|
8
|
+
3. Number formatting (codes + rules)
|
|
9
|
+
4. Multi-currency portfolios
|
|
10
|
+
5. Keyboard shortcuts
|
|
11
|
+
6. Complete workflows (5-phase aligned)
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 1. paste_content — Styled Data Entry
|
|
16
|
+
|
|
17
|
+
**Use ONLY when you need inline text styling (bold, font colors).** For plain data + formulas, use the API instead.
|
|
18
|
+
|
|
19
|
+
### When to Use
|
|
20
|
+
- Inline styling (bold headers, colored inputs) in one HTML blob
|
|
21
|
+
- Live formulas — `=SUM(B2:C2)` pastes as a real Excel formula
|
|
22
|
+
|
|
23
|
+
### When NOT to Use
|
|
24
|
+
- Plain data without styling → use `write-range` (faster, no UIA needed)
|
|
25
|
+
- paste_content requires clicking a cell first via UIA — adds failure risk
|
|
26
|
+
|
|
27
|
+
### Example
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"type": "paste_content",
|
|
31
|
+
"payload": {
|
|
32
|
+
"content": "<table><tr><th style=\"font-weight:bold;\">Dept</th><th style=\"font-weight:bold;\">Q1</th><th style=\"font-weight:bold;\">Total</th></tr><tr><td>Sales</td><td style=\"color:#0000FF;\">100</td><td>=SUM(B2:B2)</td></tr></table>",
|
|
33
|
+
"contentType": "html",
|
|
34
|
+
"fontFamily": "Aptos"
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### What Works / What Doesn't
|
|
40
|
+
| Style | Supported | How |
|
|
41
|
+
|-------|-----------|-----|
|
|
42
|
+
| Font color | Yes | `style="color:#0000FF;"` |
|
|
43
|
+
| Bold/Italic | Yes | `style="font-weight:bold;"` or `<b>` |
|
|
44
|
+
| Formulas | Yes | Write `=SUM(B2:C2)` as cell text |
|
|
45
|
+
| Background | No | Apply after via API |
|
|
46
|
+
| Borders | No | Apply after via API |
|
|
47
|
+
|
|
48
|
+
### Workflow
|
|
49
|
+
1. Select sheet → navigate to A1
|
|
50
|
+
2. paste_content with full HTML table (ONE call)
|
|
51
|
+
3. Apply background colors, borders, number formats via API
|
|
52
|
+
4. Auto-fit columns (MANDATORY last step)
|
|
53
|
+
|
|
54
|
+
**Font:** `"Aptos"` for Office 2024+, `"Calibri"` for earlier.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 2. Professional Styling Presets
|
|
59
|
+
|
|
60
|
+
### Financial Model Color Coding
|
|
61
|
+
|
|
62
|
+
Standard color conventions for financial models. Apply via font color (`fontColorHtml` in format-range):
|
|
63
|
+
|
|
64
|
+
| Font Color | Hex | Meaning |
|
|
65
|
+
|------------|-----|---------|
|
|
66
|
+
| Blue | #0000FF | Input / assumption (user-editable) |
|
|
67
|
+
| Black | #000000 | Formula / calculation |
|
|
68
|
+
| Green | #008000 | Cross-sheet reference |
|
|
69
|
+
| Red | #FF0000 | External link or hardcoded override |
|
|
70
|
+
|
|
71
|
+
Place assumptions in dedicated labeled cells (e.g., `Tax Rate` in B3) and reference them with absolute refs (`$B$3`).
|
|
72
|
+
|
|
73
|
+
### Visual Themes
|
|
74
|
+
|
|
75
|
+
Pick the theme that best matches the user's context, or ask if unclear.
|
|
76
|
+
|
|
77
|
+
### A. Big Four / McKinsey (default for financial models)
|
|
78
|
+
|
|
79
|
+
| Element | Style |
|
|
80
|
+
|---------|-------|
|
|
81
|
+
| Headers | #4472C4 bg, white bold, centered |
|
|
82
|
+
| Data | Alternating white / #F2F2F2, left-aligned |
|
|
83
|
+
| Numbers | Right-aligned, correct decimals |
|
|
84
|
+
| Currency | Accounting format with $ |
|
|
85
|
+
| Borders | Thin gray #D9D9D9, bottom border on headers |
|
|
86
|
+
| Fonts | Calibri 10-11pt data, 12pt headers |
|
|
87
|
+
|
|
88
|
+
**Palette:** `header` #4472C4 · `input` #FFFF99 · `output` #D9D9D9 · `accent` #BDD7EE · `error` #FFC7CE
|
|
89
|
+
|
|
90
|
+
### B. Corporate / Executive (dashboards, board decks)
|
|
91
|
+
|
|
92
|
+
| Element | Style |
|
|
93
|
+
|---------|-------|
|
|
94
|
+
| Headers | #1F3864 bg (dark navy), white bold, centered |
|
|
95
|
+
| Data | White bg, left-aligned |
|
|
96
|
+
| KPI highlights | #E2EFDA bg (soft green) for positive, #FCE4EC bg (soft red) for negative |
|
|
97
|
+
| Borders | None or minimal hairline #BFBFBF |
|
|
98
|
+
| Fonts | Aptos 10pt data, 14pt section titles |
|
|
99
|
+
|
|
100
|
+
**Palette:** `header` #1F3864 · `accent` #2E75B6 · `positive` #E2EFDA · `negative` #FCE4EC · `neutral` #F2F2F2
|
|
101
|
+
|
|
102
|
+
### C. Modern Minimal (data analysis, reports)
|
|
103
|
+
|
|
104
|
+
| Element | Style |
|
|
105
|
+
|---------|-------|
|
|
106
|
+
| Headers | No fill, bold black, bottom border #000000 (medium) |
|
|
107
|
+
| Data | White bg, left-aligned |
|
|
108
|
+
| Totals | Top border (thin), bold |
|
|
109
|
+
| Borders | Bottom border on headers only, no grid |
|
|
110
|
+
| Fonts | Aptos 10pt data, 11pt headers |
|
|
111
|
+
|
|
112
|
+
**Palette:** `header-border` #000000 · `subtotal-bg` #F7F7F7 · `accent` #5B9BD5 · `muted` #A6A6A6
|
|
113
|
+
|
|
114
|
+
### Choosing a Preset
|
|
115
|
+
| User Context | Preset |
|
|
116
|
+
|--------------|--------|
|
|
117
|
+
| Financial model, valuation, budget | A (Big Four) |
|
|
118
|
+
| Executive dashboard, board report, KPI summary | B (Corporate) |
|
|
119
|
+
| Data analysis, simple report, general use | C (Modern Minimal) |
|
|
120
|
+
| User has existing file with formatting | Match existing — never override |
|
|
121
|
+
|
|
122
|
+
### Sheet Organization
|
|
123
|
+
```
|
|
124
|
+
Sheet 1: Cover/Summary Sheet 4: Outputs (Bold)
|
|
125
|
+
Sheet 2: Inputs (Blue font) Sheet 5: Charts
|
|
126
|
+
Sheet 3: Calculations (Black) Sheet 6: Raw Data
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### Section Layout
|
|
130
|
+
```
|
|
131
|
+
Row 1-2: Title (Bold, larger) Row 4: Headers (Bold, Dark Fill)
|
|
132
|
+
Row 3: Blank Row 5+: Data
|
|
133
|
+
Last: Totals (Bold, Top Border)
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## 3. Number Formatting
|
|
139
|
+
|
|
140
|
+
### Format Codes
|
|
141
|
+
|
|
142
|
+
| Format | Code | Result |
|
|
143
|
+
|--------|------|--------|
|
|
144
|
+
| Currency | `$#,##0.00` | $1,234.56 |
|
|
145
|
+
| Percentage | `0.00%` | 12.34% |
|
|
146
|
+
| Accounting | `_($* #,##0.00_)` | $ 1,234.56 |
|
|
147
|
+
| Date | `mm/dd/yyyy` | 01/15/2024 |
|
|
148
|
+
| Date (Long) | `mmmm d, yyyy` | January 15, 2024 |
|
|
149
|
+
| Number | `#,##0` | 1,234 |
|
|
150
|
+
| Decimal | `0.00` | 1234.56 |
|
|
151
|
+
|
|
152
|
+
### Formatting Rules
|
|
153
|
+
|
|
154
|
+
| Data Type | Rule | Example |
|
|
155
|
+
|-----------|------|---------|
|
|
156
|
+
| Years | Format as text or `0` — never `#,##0` | 2024 not 2,024 |
|
|
157
|
+
| Zero values | Show as dash `—` | `_($* #,##0_);_($* (#,##0);"-"` |
|
|
158
|
+
| Negatives | Parentheses, not minus sign | ($1,234) not -$1,234 |
|
|
159
|
+
| Percentages | One decimal: `0.0%` | 44.7% |
|
|
160
|
+
| Multiples | One decimal with x: `0.0"x"` | 2.5x |
|
|
161
|
+
| Currency | Accounting format for alignment | $ signs align in column |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 4. Multi-Currency Portfolios
|
|
166
|
+
|
|
167
|
+
When a workbook mixes currencies (e.g., Chinese and American stocks), follow this structure:
|
|
168
|
+
|
|
169
|
+
### Settings Sheet — Exchange Rates
|
|
170
|
+
```
|
|
171
|
+
| Parameter | Value | Description |
|
|
172
|
+
| Exchange Rate CNY | 7.25 | Chinese Yuan per USD |
|
|
173
|
+
```
|
|
174
|
+
Reference with `=Settings!$B$16` (absolute ref so it recalculates everywhere when updated).
|
|
175
|
+
|
|
176
|
+
### Portfolio Sheet Layout
|
|
177
|
+
```
|
|
178
|
+
| Stock | Shares | Price (Local) | Currency | Value (Local) | Value (USD) |
|
|
179
|
+
| AAPL | 50 | 180.00 | USD | =B2*C2 | =E2 |
|
|
180
|
+
| BABA | 100 | 85.00 | CNY | =B3*C3 | =E3/Settings!$B$16 |
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
**Key rules:**
|
|
184
|
+
- **Separate header row from data** — never write data into the header row
|
|
185
|
+
- **Currency column** — explicit label so formulas can branch (`=IF(D2="CNY", E2/rate, E2)`)
|
|
186
|
+
- **All conversions via formula** — reference the Settings exchange rate, never hardcode `7.25` in formulas
|
|
187
|
+
- **Totals in USD only** — `=SUM(F2:F20)` on the converted column, not the local-currency column
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
## 5. Keyboard Shortcuts
|
|
192
|
+
|
|
193
|
+
### Navigation
|
|
194
|
+
| Action | macOS | Windows |
|
|
195
|
+
|--------|-------|---------|
|
|
196
|
+
| Go to A1 | Cmd+Home | Ctrl+Home |
|
|
197
|
+
| Go to last cell | Cmd+End | Ctrl+End |
|
|
198
|
+
| Jump to edge | Cmd+Arrow | Ctrl+Arrow |
|
|
199
|
+
| Go to cell | Name Box → type → Enter | Same |
|
|
200
|
+
| Switch sheets | Ctrl+PageUp/Down | Ctrl+PageUp/Down |
|
|
201
|
+
|
|
202
|
+
### Editing
|
|
203
|
+
| Action | macOS | Windows |
|
|
204
|
+
|--------|-------|---------|
|
|
205
|
+
| Edit cell | F2 | F2 |
|
|
206
|
+
| New line | Option+Enter | Alt+Enter |
|
|
207
|
+
| AutoSum | Cmd+Shift+T | Alt+= |
|
|
208
|
+
| Fill down/right | Cmd+D / Cmd+R | Ctrl+D / Ctrl+R |
|
|
209
|
+
| Toggle $ref | F4 | F4 |
|
|
210
|
+
|
|
211
|
+
### Formatting
|
|
212
|
+
| Action | macOS | Windows |
|
|
213
|
+
|--------|-------|---------|
|
|
214
|
+
| Format Cells | Cmd+1 | Ctrl+1 |
|
|
215
|
+
| Bold | Cmd+B | Ctrl+B |
|
|
216
|
+
| Currency | Ctrl+Shift+$ | Ctrl+Shift+$ |
|
|
217
|
+
| Percentage | Ctrl+Shift+% | Ctrl+Shift+% |
|
|
218
|
+
| Create table | Cmd+T | Ctrl+T |
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## 6. Complete Workflows
|
|
223
|
+
|
|
224
|
+
These workflows follow the 5-phase structure from SKILL.md.
|
|
225
|
+
|
|
226
|
+
### Dashboard Workflow
|
|
227
|
+
```
|
|
228
|
+
Phase 2: Open & Discover
|
|
229
|
+
- open-or-attach-workbook (standalone call)
|
|
230
|
+
- get-sheet-dimensions → read headers
|
|
231
|
+
|
|
232
|
+
Phase 3: Write Data
|
|
233
|
+
- write-range: headers, static data, and isolated formulas (ONE call per sheet)
|
|
234
|
+
- write-formulas-batch: formula columns and any repeating formulas across rows
|
|
235
|
+
|
|
236
|
+
Phase 4: Format & Enhance
|
|
237
|
+
- format-range batch: header style, borders, number formats
|
|
238
|
+
- freeze-panes (row 1)
|
|
239
|
+
- Conditional formatting / charts (if needed)
|
|
240
|
+
|
|
241
|
+
Phase 5: Finalize
|
|
242
|
+
- auto-fit-columns (AFTER all formatting)
|
|
243
|
+
- get-status (health check — fix any errors)
|
|
244
|
+
- save-workbook
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
### API vs UIA Split
|
|
248
|
+
```
|
|
249
|
+
API (90%): write-range, write-formulas-batch, format-range, auto-fit, charts, formulas, conditional formatting
|
|
250
|
+
UIA (10%): Ribbon features, color picker, complex dialogs, screenshot verification
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
### Chart Examples
|
|
254
|
+
|
|
255
|
+
**Column chart (multi-series):**
|
|
256
|
+
```json
|
|
257
|
+
{
|
|
258
|
+
"endpoint": "/excel/add-chart-from-range",
|
|
259
|
+
"body": {
|
|
260
|
+
"sheetName": "Dashboard",
|
|
261
|
+
"valueRange": "B2:D5",
|
|
262
|
+
"xLabelRange": "A2:A5",
|
|
263
|
+
"chartType": "column",
|
|
264
|
+
"title": "Q4 Sales by Region"
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
**Pie chart (SINGLE column only):**
|
|
270
|
+
```json
|
|
271
|
+
{
|
|
272
|
+
"endpoint": "/excel/add-chart-from-range",
|
|
273
|
+
"body": {
|
|
274
|
+
"sheetName": "Dashboard",
|
|
275
|
+
"sourceSheetName": "Portfolio",
|
|
276
|
+
"valueRange": "F2:F5",
|
|
277
|
+
"xLabelRange": "A2:A5",
|
|
278
|
+
"chartType": "pie",
|
|
279
|
+
"title": "Portfolio Allocation"
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
```
|
|
283
|
+
⚠️ Pie charts display only one series — `valueRange` must be a single column (e.g., `F2:F5`), not multi-column.
|
|
284
|
+
|
|
285
|
+
Always include `xLabelRange` — without it, charts show "1, 2, 3, 4".
|
|
286
|
+
|
|
287
|
+
---
|
|
288
|
+
|
|
289
|
+
## 7. Cross-Sheet Formula Syntax
|
|
290
|
+
|
|
291
|
+
**ALWAYS use cross-sheet formulas over static values.** Write `=Data!B2`, not the number.
|
|
292
|
+
|
|
293
|
+
**CRITICAL: If a sheet name contains spaces, you MUST wrap it in single quotes.** Missing quotes → `#NAME?` error.
|
|
294
|
+
|
|
295
|
+
| Reference | Syntax |
|
|
296
|
+
|-----------|--------|
|
|
297
|
+
| No spaces | `=Data!B5` |
|
|
298
|
+
| **Has spaces** | `='US Stocks'!B5` (**single quotes required**) |
|
|
299
|
+
| Range (spaces) | `=SUM('Sales Data'!B2:B100)` |
|
|
300
|
+
| VLOOKUP (spaces) | `=VLOOKUP(A2,'US Stocks'!$A$1:$B$100,2,FALSE)` |
|
|
301
|
+
| SUMIF (spaces) | `=SUMIF('Sales Data'!$A$1:$A$100,A2,'Sales Data'!$B$1:$B$100)` |
|
|
302
|
+
| No spaces | `=SUMIF(Data!$A$1:$A$100,A2,Data!$B$1:$B$100)` |
|
|
303
|
+
|
|
304
|
+
---
|
|
305
|
+
|
|
306
|
+
## 8. Formula Templates
|
|
307
|
+
|
|
308
|
+
Use `{row}` placeholder in `write-formula` and `write-formulas-batch`; for formula columns, prefer `write-formulas-batch` with `recommended.fillStartRow` and `recommended.fillRowCount`:
|
|
309
|
+
```
|
|
310
|
+
=SUM(B{row}:D{row}) → =SUM(B2:D2), =SUM(B3:D3), ...
|
|
311
|
+
=D{row}/B{row}*100
|
|
312
|
+
=IF(E{row}>1000,"High","Low")
|
|
313
|
+
```
|
|
314
|
+
Use `{row}` not `${row}`. Escape quotes: `\"High\"`.
|
|
315
|
+
|
|
316
|
+
---
|
|
317
|
+
|
|
318
|
+
## 9. Data Hygiene — Preventing #VALUE! Errors
|
|
319
|
+
|
|
320
|
+
**NEVER include currency symbols, percent signs, or other text in numeric data values.** This is the #1 cause of `#VALUE!` errors.
|
|
321
|
+
|
|
322
|
+
| WRONG (text — causes #VALUE!) | CORRECT (number + format) |
|
|
323
|
+
|-------------------------------|---------------------------|
|
|
324
|
+
| `"$120.50"` | `120.50` with `numberFormat: "$#,##0.00"` |
|
|
325
|
+
| `"15%"` | `0.15` with `numberFormat: "0.0%"` |
|
|
326
|
+
| `"¥725.00"` | `725.00` with `numberFormat: "¥#,##0.00"` |
|
|
327
|
+
| `"1,000"` | `1000` with `numberFormat: "#,##0"` |
|
|
328
|
+
|
|
329
|
+
All display formatting goes in the `formatting` array or `numberFormat`, never in data values.
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
## 10. Prevent write-range Spillover
|
|
334
|
+
|
|
335
|
+
Each `write-range` call writes data starting at the specified range. Multiple writes to overlapping areas leave old data in uncovered rows.
|
|
336
|
+
|
|
337
|
+
**Example:**
|
|
338
|
+
```
|
|
339
|
+
Call 1: write-range to A1 with 25 rows → writes A1:A25
|
|
340
|
+
Call 2: write-range to A1 with 20 rows → writes A1:A20
|
|
341
|
+
Result: Rows 21-25 still contain OLD data — orphan rows!
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
**Rules:**
|
|
345
|
+
1. **Write each range ONCE.** Plan data arrays completely before writing.
|
|
346
|
+
2. **If you must overwrite:** Clear the range first with `clear-range`, then write.
|
|
347
|
+
3. **Never write formulas to rows beyond your data.** If data has 15 rows (2-16), don't write formulas to rows 17-20.
|
|
348
|
+
4. **After correction writes:** Read back the full area (including rows BELOW) to confirm no orphan data.
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# Repair & Recovery Reference
|
|
2
|
+
|
|
3
|
+
Detailed diagnosis, repair procedures, and recovery strategies for Excel workbook issues.
|
|
4
|
+
Load this file when Phase 5 (Verify & Repair) encounters errors that need deeper diagnosis.
|
|
5
|
+
|
|
6
|
+
**Contents:**
|
|
7
|
+
1. [Formula Error Diagnosis Tree](#formula-error-diagnosis-tree)
|
|
8
|
+
2. [Chart Repair Procedures](#chart-repair-procedures)
|
|
9
|
+
3. [Anti-Patterns](#anti-patterns)
|
|
10
|
+
4. [Write Verification Rules](#write-verification-rules)
|
|
11
|
+
5. [COM Error Recovery (Windows)](#com-error-recovery-windows)
|
|
12
|
+
6. [build-sheet Fallback (Windows)](#build-sheet-fallback-windows)
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Formula Error Diagnosis Tree
|
|
17
|
+
|
|
18
|
+
| Error Type | Common Cause | Fix |
|
|
19
|
+
|-----------|--------------|-----|
|
|
20
|
+
| `#REF!` | Referenced sheet/cell deleted or renamed. Sheet name in formula doesn't match actual name | `get-workbook-info` → compare names → rewrite formula |
|
|
21
|
+
| `#NAME?` | Sheet name with spaces missing single quotes (`=US Stocks!B5` instead of `='US Stocks'!B5`). Or typo in function name | Add single quotes. Check function spelling |
|
|
22
|
+
| `#VALUE!` | Formula references text instead of numbers. Data has currency symbols (`"$120"` instead of `120`) | Fix data: remove text formatting, use numbers + numberFormat |
|
|
23
|
+
| `#DIV/0!` | Denominator empty or zero. Total row wasn't written (silent `write-range` failure) | Check denominator cell. If empty, write missing data. Wrap with `=IFERROR(formula, 0)` |
|
|
24
|
+
| `#N/A` | VLOOKUP/MATCH can't find value. Lookup key has extra spaces or different case | Check lookup key formatting. Use `IFERROR` wrapper |
|
|
25
|
+
| `#NULL!` | Missing range operator (colon or comma) in formula | Fix formula syntax |
|
|
26
|
+
| `#NUM!` | Number too large/small or invalid math operation | Check formula logic |
|
|
27
|
+
| Cell empty | `write-range` silently failed; data never arrived. Common with total/summary rows | Read cell to confirm empty, then re-write |
|
|
28
|
+
|
|
29
|
+
### Diagnosis Procedure (per cell)
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
1. READ the broken cell with returnFormulas: true
|
|
33
|
+
→ What formula is there? What is it trying to do?
|
|
34
|
+
|
|
35
|
+
2. IDENTIFY the references in the formula
|
|
36
|
+
→ Cross-sheet? Which sheet? Which cell?
|
|
37
|
+
|
|
38
|
+
3. READ each referenced cell
|
|
39
|
+
→ Is the source cell empty? Wrong value? Wrong row?
|
|
40
|
+
|
|
41
|
+
4. COMPARE with your Phase 2 plan
|
|
42
|
+
→ Does the formula point to where you planned the data?
|
|
43
|
+
|
|
44
|
+
5. FIX the specific root cause:
|
|
45
|
+
- Wrong row number → read source sheet, find correct row
|
|
46
|
+
- Wrong sheet name → use names from get-workbook-info
|
|
47
|
+
- Missing data → write the data first, then formula auto-resolves
|
|
48
|
+
- Text in numeric field → rewrite data as numbers + formatting
|
|
49
|
+
|
|
50
|
+
6. VERIFY: read-range (returnFormulas: false)
|
|
51
|
+
→ Does it show the expected value now?
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Chart Repair Procedures
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
1. READ the chart's expected source range (valueRange)
|
|
60
|
+
→ Are cells populated with numbers (not zeros, not empty, not #REF!)?
|
|
61
|
+
|
|
62
|
+
2. If source data MISSING:
|
|
63
|
+
→ Write the missing formulas/data first
|
|
64
|
+
→ Chart should auto-update — re-check
|
|
65
|
+
|
|
66
|
+
3. If source data EXISTS but chart still empty:
|
|
67
|
+
→ delete-chart → recreate with correct parameters
|
|
68
|
+
→ Common cause: chart was created BEFORE formulas were written
|
|
69
|
+
|
|
70
|
+
4. If all-zero values:
|
|
71
|
+
→ Fix the formulas (the data problem, not the chart)
|
|
72
|
+
→ Chart auto-updates when data is fixed
|
|
73
|
+
|
|
74
|
+
5. If pie/doughnut with wrong data:
|
|
75
|
+
→ delete-chart → recreate with SINGLE-column valueRange
|
|
76
|
+
→ See reference/api/advanced.md §Pie & Doughnut Charts
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
**Limits:** Max 2 recreation attempts per chart. If still broken, STOP and report.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Anti-Patterns
|
|
84
|
+
|
|
85
|
+
**NEVER do any of these during repair:**
|
|
86
|
+
|
|
87
|
+
| Anti-Pattern | Why It's Wrong | Do This Instead |
|
|
88
|
+
|-------------|---------------|-----------------|
|
|
89
|
+
| Rewrite formula without reading first | You don't know what's wrong | `read-range` with `returnFormulas: true` first |
|
|
90
|
+
| Guess the correct row number | You WILL guess wrong after edits shift rows | Read the source sheet to find the actual row |
|
|
91
|
+
| Replace formula with hardcoded number | Breaks dynamic recalculation | Fix the formula to reference the correct cell |
|
|
92
|
+
| Write multiple fixes without verifying | Fixes can interact and cascade | Verify each fix before the next |
|
|
93
|
+
| Overwrite raw data with formulas | Destroys source data, may create circular refs | Computed columns go AFTER all data columns |
|
|
94
|
+
| Fix symptoms instead of root causes | Same error will recur or cascade | Follow diagnosis tree to find actual root cause |
|
|
95
|
+
| Call same endpoint with same params repeatedly | You're in a loop — the approach is wrong | STOP, rethink, try a different fix strategy |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Write Verification Rules
|
|
100
|
+
|
|
101
|
+
### After write-range
|
|
102
|
+
|
|
103
|
+
`write-range` may return HTTP 200 but silently write zero rows. This happens frequently with total/summary rows appended beyond the main data block.
|
|
104
|
+
|
|
105
|
+
**After ANY write-range that writes static totals or isolated formulas:**
|
|
106
|
+
1. Call `read-range` on 1–2 cells you just wrote
|
|
107
|
+
2. If empty → the write silently failed → retry
|
|
108
|
+
3. Common cause: writing to rows beyond the used range
|
|
109
|
+
|
|
110
|
+
For repeated formula columns, use `write-formulas-batch` with `recommended.fillStartRow` and `recommended.fillRowCount`, then spot-check `recommended.spotVerifyRows` with `returnFormulas:true`.
|
|
111
|
+
|
|
112
|
+
### Dashboard References
|
|
113
|
+
|
|
114
|
+
Before writing ANY cross-sheet formula on a Dashboard sheet:
|
|
115
|
+
1. `read-range` the target cell (e.g., `Portfolio!I19`) → confirm it has the expected value
|
|
116
|
+
2. If empty or 0 → the target row is missing → write it first, verify again
|
|
117
|
+
3. Only THEN write the Dashboard formula
|
|
118
|
+
|
|
119
|
+
**Never blindly write `='Portfolio'!I19` without confirming I19 exists.** Silent write failures cascade: empty total → 0% weights → $0 on Dashboard → #DIV/0! in ratios.
|
|
120
|
+
|
|
121
|
+
### Raw Data Protection
|
|
122
|
+
|
|
123
|
+
When a sheet has monthly/periodic data (e.g., Jan–Jun in columns C–H), those columns contain **source values**. NEVER replace a data cell with a formula. Totals, averages, and percentages go in **separate columns after the data**.
|
|
124
|
+
|
|
125
|
+
**Wrong:** Overwriting C2 (Jan Salary = 8500) with a formula — destroys raw value AND may create circular reference.
|
|
126
|
+
**Correct:** Leave C2 = 8500. Put `=SUM(C2:H2)` in I2 and `=AVERAGE(C2:H2)` in J2.
|
|
127
|
+
|
|
128
|
+
### Prevent write-range Spillover
|
|
129
|
+
|
|
130
|
+
Each `write-range` writes data starting at the specified range. Multiple writes to overlapping areas leave old data in rows the second call doesn't cover.
|
|
131
|
+
|
|
132
|
+
**Rules:**
|
|
133
|
+
1. **Write each range ONCE.** Plan data arrays completely before writing.
|
|
134
|
+
2. **If you must overwrite:** Clear the range first with `clear-range`, then write.
|
|
135
|
+
3. **Never write formulas to rows beyond your data.** If data has 15 rows, don't write formulas to row 20.
|
|
136
|
+
4. **After correction writes:** Read back the full area (including rows BELOW) to confirm no orphan data.
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## COM Error Recovery (Windows)
|
|
141
|
+
|
|
142
|
+
When an Excel API call fails with a COM error, **DO NOT switch to UIA**. Follow this recovery sequence:
|
|
143
|
+
|
|
144
|
+
| Step | Action | Details |
|
|
145
|
+
|------|--------|---------|
|
|
146
|
+
| 1 | Wait 3 seconds | COM object may be temporarily unavailable |
|
|
147
|
+
| 2 | Retry same API call | Interop has auto-reconnect logic |
|
|
148
|
+
| 3 | Check Excel health | Call `list-open-workbooks` — if it responds, call `open-or-attach-workbook` to reconnect |
|
|
149
|
+
| 4 | If all fail | Tell user: "Excel became unresponsive. Please close any Excel windows and try again." |
|
|
150
|
+
| 5 | Fall back to build-sheet | If `build-workbook` specifically fails after retries |
|
|
151
|
+
| 6 | UIA as absolute last resort | Only after ALL API recovery steps have been exhausted |
|
|
152
|
+
|
|
153
|
+
**Common COM errors:**
|
|
154
|
+
|
|
155
|
+
| Error | Meaning | Recovery |
|
|
156
|
+
|-------|---------|----------|
|
|
157
|
+
| `RPC_E_DISCONNECTED (0x80010108)` | Excel process died or zombie blocking | Close Excel via Task Manager, retry |
|
|
158
|
+
| `RPC_E_SERVERCALL_RETRYLATER (0x8001010A)` | Excel is busy (dialog, calculating) | Auto-retried by interop — wait |
|
|
159
|
+
| `RPC_E_CALL_REJECTED (0x80010001)` | Excel rejected COM call | Auto-retried by interop — wait |
|
|
160
|
+
| `E_FAIL (0x80004005)` | Generic COM failure | Retry once, then fall back to build-sheet |
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## build-sheet Fallback (Windows)
|
|
165
|
+
|
|
166
|
+
When `build-workbook` fails and you fall back to individual `build-sheet` calls:
|
|
167
|
+
|
|
168
|
+
1. **`=@SheetName[Label]` resolves in `build-sheet` ONLY if the referenced sheet already exists** — server reads the referenced sheet's column A at call time. If a partial `build-workbook` failure left some sheets unwritten, refs to those sheets won't resolve.
|
|
169
|
+
2. **Build in dependency order** — write referenced sheets BEFORE sheets that reference them. Same-sheet refs (`B[Label]` without `@`) always work since labels and dependents land in the same write.
|
|
170
|
+
3. **For refs to sheets that aren't built yet, rewrite as explicit cell refs** — e.g., `=@Portfolio[TOTAL]` → `='Portfolio'!B24`. Use `read-range` after each sheet to find the actual row number.
|
|
171
|
+
4. **Sheet names with spaces need single quotes** — `='US Stocks'!E10`
|
|
172
|
+
5. **Verify every cross-sheet reference** — read 2–3 cells to confirm values are correct
|
|
173
|
+
|
|
174
|
+
**After the last sheet:** Call `save-workbook` and `get-status` to save and verify.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Troubleshooting Reference
|
|
2
|
+
|
|
3
|
+
Complete troubleshooting table for Excel Architect. The top 5 most common issues are in the main skill file — consult this table for the full list.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
| # | Issue | Solution |
|
|
8
|
+
|---|-------|----------|
|
|
9
|
+
| 1 | Range timeout | Use specific range (e.g., `A1:A100`), never `A:A` or `1:1` |
|
|
10
|
+
| 2 | Sheet not found | Use exact names from `get-workbook-info` |
|
|
11
|
+
| 3 | `#REF!` error | Sheet name in formula doesn't match actual — run `get-workbook-info` |
|
|
12
|
+
| 4 | `#NAME?` error | Sheet name with spaces missing quotes, or typo in function name |
|
|
13
|
+
| 5 | `#VALUE!` error | Data has currency/% symbols as text — use numbers + numberFormat |
|
|
14
|
+
| 6 | `#DIV/0!` error | Denominator empty/zero — wrap with `IFERROR` or fix source data |
|
|
15
|
+
| 7 | Write is slow | Batch ALL data in ONE `write-range` call |
|
|
16
|
+
| 8 | `#######` in cells | Auto-fit columns |
|
|
17
|
+
| 9 | Stale data | Read dimensions before operating |
|
|
18
|
+
| 10 | Wrong workbook targeted | Always pass workbookId or filePath |
|
|
19
|
+
| 11 | Chart appears empty/flat | Source column has no formulas — write formulas first, then chart |
|
|
20
|
+
| 12 | `build-sheet` cross-refs broken | `=@SheetName[Label]` works in `build-sheet` only if the referenced sheet already exists in the workbook. Build in dependency order, or use explicit `='Sheet'!B24` refs for sheets not yet written |
|
|
21
|
+
| 13 | Dashboard shows wrong values | Cross-sheet ref points to wrong cell — read target cell to verify |
|
|
22
|
+
| 14 | All cross-sheet formulas `#REF!` | Sheet name mismatch — run `get-workbook-info` to check |
|
|
23
|
+
| 15 | `get-status` returns empty but errors exist | Data beyond row 1000 or column AE not scanned; 10-second timeout |
|
|
24
|
+
| 16 | Reported values don't match file | Always `read-range` actual cell before reporting — never compute mentally |
|
|
25
|
+
| 17 | COM error (`RPC_E_DISCONNECTED`) | Wait 3s, retry. See `reference/repair.md` §COM Error Recovery |
|
|
26
|
+
| 18 | `build-workbook` fails on creation | Retry once. If still failing, use `create-workbook` + `build-sheet` individually |
|
|
27
|
+
| 19 | `write-range` returns 200 but cells empty | Write silently failed — `read-range` to verify, then retry |
|
|
28
|
+
| 20 | Data column overwritten with formulas | NEVER put computed formulas in raw data columns. Totals go in separate columns |
|
|
29
|
+
| 21 | Dashboard shows $0 for cross-sheet refs | Target cell is empty — verify with `read-range` before writing formula |
|
|
30
|
+
| 22 | All Weight % show 0.0% | Total row (divisor) empty — `write-range` silently failed. Rewrite total first |
|
|
31
|
+
| 23 | Pie chart empty or wrong data | Use single-column `valueRange` — see `reference/api/advanced.md` §Pie & Doughnut Charts |
|
|
32
|
+
| 24 | Chart API response has WARNINGs | Source data empty/zero or pie has multiple series. Fix data, recreate chart |
|
|
33
|
+
| 25 | Orphan data rows after corrections | Multiple writes to overlapping areas. Clear range first, or write complete data |
|
|
34
|
+
| 26 | Chart shows zeros despite data | Chart created BEFORE formulas. Write formulas first, then create chart |
|
|
35
|
+
| 27 | Fixing formulas makes things worse | STOP. Read with `returnFormulas: true` first. See `reference/repair.md` |
|
|
36
|
+
| 28 | Same error keeps recurring | Fixing symptom, not cause. Read the referenced cell — problem is in SOURCE data |
|
|
37
|
+
| 29 | Agent loops endlessly | Respect stop conditions: max 3 per cell, max 10 total repairs |
|
|
38
|
+
| 30 | Chart broken after fixing source | Chart was created with wrong range. `delete-chart` → recreate with correct params |
|
|
39
|
+
| 31 | Dashboard built before source sheets | Follow Phase 3 build order: foundation → computed → aggregation |
|
|
40
|
+
| 32 | Formula references wrong row | Read source sheet to find correct row — don't guess |
|
|
41
|
+
| 33 | Many errors in Phase 5 | You skipped Phase 3 incremental verification. Health-check each sheet |
|
|
42
|
+
| 34 | Agent rewrites formulas repeatedly | STOP — `read-range` with `returnFormulas: true` to understand what's wrong |
|
|
43
|
+
| 35 | Cross-sheet formula points to label | Formula says `=Sheet!A12` (label) instead of `=Sheet!B12` (value). Verify column letter |
|
|
44
|
+
| 36 | Archetype doesn't match request | Pick closest archetype, then customize. Archetype is a starting point |
|
|
45
|
+
| 37 | No research results found | Use reasonable defaults and note assumptions to user |
|
|
46
|
+
| 38 | Model invents structure | Re-read archetype file. Sheet structure and row layouts are mandatory |
|