@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,458 @@
|
|
|
1
|
+
# PowerPoint Architect - Windows API Reference
|
|
2
|
+
|
|
3
|
+
Windows-specific PowerPoint automation via **ExecuteSkillApi** endpoints and **C# scripting**.
|
|
4
|
+
|
|
5
|
+
## Execution Priority (Windows)
|
|
6
|
+
|
|
7
|
+
| Priority | Approach | Tool | Speed | Best For |
|
|
8
|
+
|----------|----------|------|-------|----------|
|
|
9
|
+
| **1st** | API | ExecuteSkillApi | Fastest | Slides, text, images, tables, charts |
|
|
10
|
+
| **2nd** | C# Script | `/ppt/execute-script` | Fast | Complex logic, custom automation |
|
|
11
|
+
| **3rd** | UIA | AppAct | Slowest | Ribbon clicks, dialogs, animations |
|
|
12
|
+
|
|
13
|
+
If the user forbids arbitrary Office scripts, never call `/ppt/execute-script`. Use structured `/ppt/*` endpoints or report the limitation.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Quick Reference
|
|
18
|
+
|
|
19
|
+
### Creation (New Presentation)
|
|
20
|
+
| Task | Endpoint | Key Parameters |
|
|
21
|
+
|------|----------|----------------|
|
|
22
|
+
| Generate new presentation | `/ppt-gen/generate` | options (title, theme/themePath, outputPath), slides |
|
|
23
|
+
| List generator themes | `/ppt-gen/list-themes` | - |
|
|
24
|
+
| Render Mermaid diagram to PNG | `/diagram/render-mermaid` | code, outputPath |
|
|
25
|
+
|
|
26
|
+
**Note:** `/ppt-gen/*` creates presentations from scratch (no PowerPoint needed). `/ppt/*` (below) drives an already-open PowerPoint window for editing. Do NOT use `/ppt/generate` or `/ppt/create-presentation` — those endpoints do not exist. See `generator-reference.md` for the `/ppt-gen/generate` JSON format.
|
|
27
|
+
|
|
28
|
+
### Lifecycle Operations
|
|
29
|
+
| Task | Endpoint | Key Parameters |
|
|
30
|
+
|------|----------|----------------|
|
|
31
|
+
| Open/attach presentation | `/ppt/open-attach` | filePath, createNew, visible (default false = windowless) |
|
|
32
|
+
| Close presentation | `/ppt/close` | filePath |
|
|
33
|
+
| Get presentation info | `/ppt/get-presentation-info` | filePath |
|
|
34
|
+
| Get opened files | `/ppt/get-opened-files` | - |
|
|
35
|
+
| Get recent files | `/ppt/get-recent-files` | - |
|
|
36
|
+
| Save as PDF | `/ppt/save-as-pdf` | filePath, pdfFilePath |
|
|
37
|
+
|
|
38
|
+
### Slide Operations
|
|
39
|
+
| Task | Endpoint | Key Parameters |
|
|
40
|
+
|------|----------|----------------|
|
|
41
|
+
| Insert slide | `/ppt/insert-slide` | filePath, position, slideLayout |
|
|
42
|
+
| Select slide | `/ppt/select-slide` | filePath, slideNumber. **Needs `visible: true` on open** |
|
|
43
|
+
| Delete slide | `/ppt/delete-slide` | filePath, slideNumber |
|
|
44
|
+
| Duplicate slides | `/ppt/duplicate-slides` | filePath, startSlideNumber, count |
|
|
45
|
+
| Reorder/move slide | `/ppt/reorder-slide` | filePath, slideNumber, newPosition |
|
|
46
|
+
| Copy slides | `/ppt/copy-slides` | sourceFilePath, targetFilePath, startSlideNumber, endSlideNumber |
|
|
47
|
+
| Get current slide | `/ppt/get-current-slide-number` | filePath |
|
|
48
|
+
|
|
49
|
+
### Content Operations
|
|
50
|
+
| Task | Endpoint | Key Parameters |
|
|
51
|
+
|------|----------|----------------|
|
|
52
|
+
| Add text to slide | `/ppt/add-text-to-slide` | filePath, slideNumber, targetShapeName, text |
|
|
53
|
+
| Add speaker notes | `/ppt/add-speaker-notes` | filePath, slideNumber, notes |
|
|
54
|
+
| Replace text | `/ppt/replace-text` | filePath, oldText, newText |
|
|
55
|
+
| Insert image | `/ppt/insert-image` | filePath, slideNumber, imagePath |
|
|
56
|
+
| Replace image | `/ppt/replace-image` | filePath, slideNumber, imagePath, targetShapeName |
|
|
57
|
+
| Insert table | `/ppt/insert-table` | filePath, slideNumber, table |
|
|
58
|
+
| Insert chart | `/ppt/insert-chart` | filePath, slideNumber, chartType, categories, series |
|
|
59
|
+
|
|
60
|
+
### Analysis Operations
|
|
61
|
+
| Task | Endpoint | Key Parameters |
|
|
62
|
+
|------|----------|----------------|
|
|
63
|
+
| Analyze slide content | `/ppt/analyze-slide-content` | filePath, slideNumbers |
|
|
64
|
+
| Review slides | `/ppt/review-slides` | filePath, slideNumbers, checks |
|
|
65
|
+
| Extract slide data | `/ppt/extract-slide-data` | filePath, slideNumber |
|
|
66
|
+
|
|
67
|
+
### Formatting Operations
|
|
68
|
+
| Task | Endpoint | Key Parameters |
|
|
69
|
+
|------|----------|----------------|
|
|
70
|
+
| Format slide content | `/ppt/format-slide-content` | filePath, slideNumbers, shapeName, textMatch, fontSize, bold |
|
|
71
|
+
| Format shape | `/ppt/format-shape` | filePath, slideNumber, shapeName, left, top |
|
|
72
|
+
| Optimize slide | `/ppt/optimize-slide` | filePath, slideNumber |
|
|
73
|
+
| Apply theme (editing only!) | `/ppt/apply-theme` | filePath, themeName or themeFilePath |
|
|
74
|
+
|
|
75
|
+
### Scripting
|
|
76
|
+
| Task | Endpoint | Key Parameters |
|
|
77
|
+
|------|----------|----------------|
|
|
78
|
+
| Execute C# script | `/ppt/execute-script` | filePath, script, slideNumber |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Critical Rules
|
|
83
|
+
|
|
84
|
+
| Rule | Description |
|
|
85
|
+
|------|-------------|
|
|
86
|
+
| **Open first** | Always call `/ppt/open-attach` before any operation |
|
|
87
|
+
| **Analyze before edit** | Always call `/ppt/analyze-slide-content` to get shape names |
|
|
88
|
+
| **Use exact shape names** | Copy existing shape names exactly from analyze response. If a new slide returns `shapes: []`, use the zero-shape recovery below. |
|
|
89
|
+
| **Extract via API** | Use `/ppt/extract-slide-data` for tables/text/charts - NEVER scripts |
|
|
90
|
+
| **clearExistingText: true** | When replacing content, ALWAYS use `clearExistingText: true` to prevent doubling |
|
|
91
|
+
| **Health check + fix** | Run `/ppt/review-slides` and fix its warnings in one pass before declaring success; report what remains (SKILL.md Core Principle 4) |
|
|
92
|
+
| **Shape names are case-sensitive** | "Title 1" != "title 1" |
|
|
93
|
+
| **Slide numbers are 1-based** | First slide = 1, not 0 |
|
|
94
|
+
| **Auto-save enabled** | Changes save automatically, no explicit save needed |
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## SharePoint / OneDrive Files
|
|
99
|
+
|
|
100
|
+
To open a file from SharePoint or OneDrive, use PowerShell — **never download via HTTP** (auth will fail) or click through browser UI:
|
|
101
|
+
|
|
102
|
+
```
|
|
103
|
+
ExecutePowershellCommand: Start-Process "POWERPNT.EXE" -ArgumentList "/o `"<url>`""
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Get the URL from the **browser address bar** — do not construct it yourself. Then call `/ppt/get-opened-files` to confirm it loaded. The returned `filePath` will be a URL — use it as-is in all `/ppt/*` endpoints (`filePath`, `sourceFilePath`, etc.).
|
|
107
|
+
|
|
108
|
+
### Copy slides from SharePoint to local file
|
|
109
|
+
```json
|
|
110
|
+
// 1. Open SharePoint file via PowerShell (get URL from browser)
|
|
111
|
+
// 2. Create local target
|
|
112
|
+
{ "endpoint": "/ppt/open-attach", "body": { "filePath": "C:\\Users\\me\\Documents\\Copy.pptx", "createNew": true } }
|
|
113
|
+
// 3. Copy slides using startSlideNumber + endSlideNumber (NOT "count" or "slideNumbers")
|
|
114
|
+
{ "endpoint": "/ppt/copy-slides", "body": {
|
|
115
|
+
"sourceFilePath": "https://company.sharepoint.com/.../file.pptx",
|
|
116
|
+
"targetFilePath": "C:\\Users\\me\\Documents\\Copy.pptx",
|
|
117
|
+
"startSlideNumber": 1,
|
|
118
|
+
"endSlideNumber": 3
|
|
119
|
+
} }
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Discovery-First Workflow
|
|
125
|
+
|
|
126
|
+
Before editing, ALWAYS discover the presentation structure:
|
|
127
|
+
|
|
128
|
+
```
|
|
129
|
+
1. Open/Attach -> Get file reference and slide list
|
|
130
|
+
2. Analyze -> Get shape names and layout for target slide(s)
|
|
131
|
+
3. Plan -> Determine what changes to make
|
|
132
|
+
4. Execute -> Perform operations using exact shape names
|
|
133
|
+
5. Health Check -> Run /ppt/review-slides to verify quality
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## Common Patterns
|
|
139
|
+
|
|
140
|
+
### Open and Analyze Presentation
|
|
141
|
+
```json
|
|
142
|
+
// Step 1: Open
|
|
143
|
+
{
|
|
144
|
+
"endpoint": "/ppt/open-attach",
|
|
145
|
+
"body": {
|
|
146
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx"
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
// Response: { "success": true, "filePath": "...", "slides": [...], "totalSlides": 10 }
|
|
150
|
+
|
|
151
|
+
// Step 2: Analyze specific slides
|
|
152
|
+
{
|
|
153
|
+
"endpoint": "/ppt/analyze-slide-content",
|
|
154
|
+
"body": {
|
|
155
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
156
|
+
"slideNumbers": [1, 2, 3]
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
// Response includes shape names: ["Title 1", "Content Placeholder 2", ...]
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### Add Content to Existing Slide
|
|
163
|
+
```json
|
|
164
|
+
// Use shape names from analyze response
|
|
165
|
+
{
|
|
166
|
+
"endpoint": "/ppt/add-text-to-slide",
|
|
167
|
+
"body": {
|
|
168
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
169
|
+
"slideNumber": 2,
|
|
170
|
+
"targetShapeName": "Content Placeholder 2",
|
|
171
|
+
"text": "- Point 1\n- Point 2\n- Point 3",
|
|
172
|
+
"clearExistingText": true
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### Insert New Slide with Content
|
|
178
|
+
```json
|
|
179
|
+
// Step 1: Insert slide
|
|
180
|
+
{
|
|
181
|
+
"endpoint": "/ppt/insert-slide",
|
|
182
|
+
"body": {
|
|
183
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
184
|
+
"position": 4,
|
|
185
|
+
"slideLayout": "Title and Content"
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
// Response includes available shapes for the new slide.
|
|
189
|
+
// If the response has shapes: [], use the Windows zero-shape recovery below.
|
|
190
|
+
|
|
191
|
+
// Step 2: Add title
|
|
192
|
+
{
|
|
193
|
+
"endpoint": "/ppt/add-text-to-slide",
|
|
194
|
+
"body": {
|
|
195
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
196
|
+
"slideNumber": 4,
|
|
197
|
+
"targetShapeName": "Title 1",
|
|
198
|
+
"text": "New Section Title"
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
// Step 3: Add body content
|
|
203
|
+
{
|
|
204
|
+
"endpoint": "/ppt/add-text-to-slide",
|
|
205
|
+
"body": {
|
|
206
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
207
|
+
"slideNumber": 4,
|
|
208
|
+
"targetShapeName": "Content Placeholder 2",
|
|
209
|
+
"text": "- Key point 1\n- Key point 2\n- Key point 3"
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
// Step 4: Health check
|
|
214
|
+
{
|
|
215
|
+
"endpoint": "/ppt/review-slides",
|
|
216
|
+
"body": {
|
|
217
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
218
|
+
"slideNumbers": [4]
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
**Windows zero-shape recovery:** If `/ppt/insert-slide` returns `shapes: []`, call `/ppt/add-text-to-slide` with a deterministic new `targetShapeName`, such as `DelegateTextBox`. On Windows, a missing target shape makes this structured endpoint auto-create the text box and persist the presentation.
|
|
224
|
+
|
|
225
|
+
```json
|
|
226
|
+
{
|
|
227
|
+
"endpoint": "/ppt/add-text-to-slide",
|
|
228
|
+
"body": {
|
|
229
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
230
|
+
"slideNumber": 4,
|
|
231
|
+
"targetShapeName": "DelegateTextBox",
|
|
232
|
+
"text": "New slide content"
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
Do not use `/ppt/execute-script` for zero-shape recovery. Do not call the nonexistent Windows `/ppt/save-presentation` endpoint or script `Save()`; structured native mutations auto-save.
|
|
238
|
+
|
|
239
|
+
### Health Check (Run After Every Edit)
|
|
240
|
+
```json
|
|
241
|
+
// Review all slides for issues
|
|
242
|
+
{
|
|
243
|
+
"endpoint": "/ppt/review-slides",
|
|
244
|
+
"body": {
|
|
245
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx"
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
// Response includes: summary (issues, warnings, critical), per-slide issues, recommendations
|
|
249
|
+
|
|
250
|
+
// Review specific slides only
|
|
251
|
+
{
|
|
252
|
+
"endpoint": "/ppt/review-slides",
|
|
253
|
+
"body": {
|
|
254
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
255
|
+
"slideNumbers": [2, 3, 4]
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### Insert Table
|
|
261
|
+
```json
|
|
262
|
+
{
|
|
263
|
+
"endpoint": "/ppt/insert-table",
|
|
264
|
+
"body": {
|
|
265
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
266
|
+
"slideNumber": 3,
|
|
267
|
+
"table": [
|
|
268
|
+
["Header 1", "Header 2", "Header 3"],
|
|
269
|
+
["Row 1 A", "Row 1 B", "Row 1 C"],
|
|
270
|
+
["Row 2 A", "Row 2 B", "Row 2 C"]
|
|
271
|
+
]
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
### Insert Chart
|
|
277
|
+
```json
|
|
278
|
+
{
|
|
279
|
+
"endpoint": "/ppt/insert-chart",
|
|
280
|
+
"body": {
|
|
281
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
282
|
+
"slideNumber": 5,
|
|
283
|
+
"chartType": "Column",
|
|
284
|
+
"chartTitle": "Quarterly Sales",
|
|
285
|
+
"categories": ["Q1", "Q2", "Q3", "Q4"],
|
|
286
|
+
"series": [
|
|
287
|
+
{ "name": "2023", "values": [100, 150, 200, 175] },
|
|
288
|
+
{ "name": "2024", "values": [120, 180, 220, 210] }
|
|
289
|
+
]
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
### Insert Image
|
|
295
|
+
|
|
296
|
+
**⚠️ ALWAYS use `targetShapeName` - omitting it causes overlapping!**
|
|
297
|
+
|
|
298
|
+
```json
|
|
299
|
+
// 1. Analyze slide to get placeholder name
|
|
300
|
+
{"endpoint": "/ppt/analyze-slide-content", "body": {"filePath": "...", "slideNumbers": [3]}}
|
|
301
|
+
// → Returns: "Picture Placeholder 2" or "Content Placeholder 2"
|
|
302
|
+
|
|
303
|
+
// 2. Insert image INTO placeholder
|
|
304
|
+
{"endpoint": "/ppt/insert-image", "body": {
|
|
305
|
+
"filePath": "...",
|
|
306
|
+
"slideNumber": 3,
|
|
307
|
+
"imagePath": "C:/path/to/image.png",
|
|
308
|
+
"targetShapeName": "Picture Placeholder 2"
|
|
309
|
+
}}
|
|
310
|
+
```
|
|
311
|
+
|
|
312
|
+
**Image-friendly layouts:** `Picture with Caption`, `Title and Content`, `Two Content`
|
|
313
|
+
|
|
314
|
+
### Format Text
|
|
315
|
+
|
|
316
|
+
**Whole shape** — formats all text in the shape:
|
|
317
|
+
```json
|
|
318
|
+
{
|
|
319
|
+
"endpoint": "/ppt/format-slide-content",
|
|
320
|
+
"body": {
|
|
321
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
322
|
+
"slideNumbers": [1],
|
|
323
|
+
"shapeName": "Title 1",
|
|
324
|
+
"fontSize": 44,
|
|
325
|
+
"bold": true,
|
|
326
|
+
"fontColor": "#003366"
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
**Targeted text** — formats only the matched text (use for sub-headers, keywords, highlights):
|
|
332
|
+
```json
|
|
333
|
+
{
|
|
334
|
+
"endpoint": "/ppt/format-slide-content",
|
|
335
|
+
"body": {
|
|
336
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
337
|
+
"slideNumbers": [13],
|
|
338
|
+
"shapeName": "Text Placeholder 2",
|
|
339
|
+
"textMatch": "Key Features:",
|
|
340
|
+
"bold": true,
|
|
341
|
+
"fontSize": 20
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
```
|
|
345
|
+
`textMatch` finds all occurrences of the exact text (case-insensitive) and applies formatting only to those characters. Use this to bold sub-headers like "Key Features:", highlight keywords, or change the color of specific phrases without affecting the rest of the shape.
|
|
346
|
+
|
|
347
|
+
### Apply Theme (EDITING ONLY)
|
|
348
|
+
|
|
349
|
+
**⚠️ For CREATING new presentations with a custom theme, use `themePath` in the generator JSON options instead! This API is only for changing themes on EXISTING presentations.**
|
|
350
|
+
|
|
351
|
+
```json
|
|
352
|
+
// From built-in theme name
|
|
353
|
+
{
|
|
354
|
+
"endpoint": "/ppt/apply-theme",
|
|
355
|
+
"body": {
|
|
356
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
357
|
+
"themeName": "Office Theme"
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
// From custom .thmx file
|
|
362
|
+
{
|
|
363
|
+
"endpoint": "/ppt/apply-theme",
|
|
364
|
+
"body": {
|
|
365
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
366
|
+
"themeFilePath": "C:/Themes/Corporate.thmx"
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
---
|
|
372
|
+
|
|
373
|
+
## Available Slide Layouts
|
|
374
|
+
|
|
375
|
+
When using `/ppt/insert-slide`, specify one of these layout names:
|
|
376
|
+
|
|
377
|
+
| Layout Name | Description |
|
|
378
|
+
|-------------|-------------|
|
|
379
|
+
| Title Slide | Title + subtitle centered |
|
|
380
|
+
| Title and Content | Title + content placeholder |
|
|
381
|
+
| Section Header | Section title |
|
|
382
|
+
| Two Content | Title + two side columns |
|
|
383
|
+
| Comparison | Title + two columns with headers |
|
|
384
|
+
| Title Only | Just title |
|
|
385
|
+
| Blank | Empty slide |
|
|
386
|
+
| Content with Caption | Content + side caption |
|
|
387
|
+
| Picture with Caption | Large picture + caption |
|
|
388
|
+
|
|
389
|
+
---
|
|
390
|
+
|
|
391
|
+
## Documentation (Load When Needed)
|
|
392
|
+
|
|
393
|
+
### Workflow Examples
|
|
394
|
+
| File | Content | When to Load |
|
|
395
|
+
|------|---------|--------------|
|
|
396
|
+
| `windows/examples/level-1-workflows.md` | End-to-end workflow patterns | Learning common patterns |
|
|
397
|
+
| `windows/examples/level-2-scripting.md` | C# scripting patterns | When API endpoints are insufficient |
|
|
398
|
+
|
|
399
|
+
### API Schemas
|
|
400
|
+
| File | Endpoints | When to Load |
|
|
401
|
+
|------|-----------|--------------|
|
|
402
|
+
| `windows/api/basic.md` | Lifecycle, slides, content | Essential operations |
|
|
403
|
+
| `windows/api/advanced.md` | Formatting, charts, tables, themes | Advanced operations |
|
|
404
|
+
|
|
405
|
+
### Issue Fixing Reference
|
|
406
|
+
| File | Content | When to Load |
|
|
407
|
+
|------|---------|--------------|
|
|
408
|
+
| `issue-fix-mapping.md` | Fix patterns for ALL health check issues | **When fixing health check warnings** |
|
|
409
|
+
|
|
410
|
+
---
|
|
411
|
+
|
|
412
|
+
## Troubleshooting
|
|
413
|
+
|
|
414
|
+
| Error | Cause | Solution |
|
|
415
|
+
|-------|-------|----------|
|
|
416
|
+
| `Shape not found` | Wrong shape name | Run `/ppt/analyze-slide-content` to get exact names |
|
|
417
|
+
| `No active presentation` | File not open | Call `/ppt/open-attach` first |
|
|
418
|
+
| `Slide not found` | Invalid slide number | Slide numbers are 1-based (first slide = 1) |
|
|
419
|
+
| `File already exists` | Output path exists (generator) | Use different filename or delete existing |
|
|
420
|
+
| `PowerPoint not running` | Application not started | `/ppt/open-attach` will start PowerPoint |
|
|
421
|
+
|
|
422
|
+
### Chart Text Colors on Dark Themes (Auto-Fixed)
|
|
423
|
+
|
|
424
|
+
**Good news:** The `/ppt/insert-chart` endpoint now **automatically detects** the slide background color and applies appropriate contrasting text colors to chart elements (legend, title, axis labels).
|
|
425
|
+
|
|
426
|
+
- **Dark backgrounds** (luminance < 50%): White text is applied
|
|
427
|
+
- **Light backgrounds** (luminance >= 50%): Black text is applied
|
|
428
|
+
|
|
429
|
+
This means you no longer need to manually fix chart colors. Just insert the chart and run the health check:
|
|
430
|
+
|
|
431
|
+
```
|
|
432
|
+
1. `/ppt/insert-chart` - Insert the chart (colors auto-adjusted)
|
|
433
|
+
2. `/ppt/review-slides` - Verify visibility
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
**Note:** If you need to manually override chart colors for any reason, you can still use `/ppt/execute-script` with custom C# code.
|
|
437
|
+
|
|
438
|
+
### Modifying Chart Data via Script
|
|
439
|
+
|
|
440
|
+
Use `/ppt/execute-script` to modify chart data after a chart has been created:
|
|
441
|
+
|
|
442
|
+
```json
|
|
443
|
+
{
|
|
444
|
+
"endpoint": "/ppt/execute-script",
|
|
445
|
+
"body": {
|
|
446
|
+
"filePath": "C:/Users/me/Documents/presentation.pptx",
|
|
447
|
+
"slideNumber": 5,
|
|
448
|
+
"script": "// Find chart shape and modify data\nforeach (dynamic shape in slide.Shapes) {\n if (shape.HasChart == MsoTriState.msoTrue) {\n dynamic wb = shape.Chart.ChartData.Workbook;\n dynamic ws = wb.Worksheets[1];\n ws.Cells[2, 1].Value = \"New Category Name\";\n ws.Cells[2, 2].Value = 150; // Update value\n shape.Chart.Refresh();\n break;\n }\n}\nreturn \"Chart data updated\";"
|
|
449
|
+
}
|
|
450
|
+
}
|
|
451
|
+
```
|
|
452
|
+
|
|
453
|
+
**Key points for chart data scripts:**
|
|
454
|
+
- Chart data is stored in an embedded Excel workbook accessed via `shape.Chart.ChartData.Workbook`
|
|
455
|
+
- Use `dynamic` type for all COM objects (script runner auto-converts `var` to `dynamic` for chart objects)
|
|
456
|
+
- Row 1 contains series headers, column A contains category labels
|
|
457
|
+
- Call `chart.Refresh()` after modifying data to update the visual
|
|
458
|
+
- Available namespaces: `Microsoft.Office.Interop.PowerPoint`, `Microsoft.Office.Interop.Excel`, `Microsoft.Office.Core`
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
# Custom Theme Workflow (.thmx / .pptx)
|
|
2
|
+
|
|
3
|
+
**When user provides a `.thmx` or `.pptx` file as theme source, use the Generator with `themePath`.**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Single-Step Process (Generator handles everything)
|
|
8
|
+
|
|
9
|
+
**The Generator creates ALL slides with ALL content in ONE call when using `themePath`.** Include every slide in the `slides` array — the Generator applies the theme and generates all slides at once.
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"options": {
|
|
14
|
+
"title": "My Presentation",
|
|
15
|
+
"themePath": "/path/to/Theme1.thmx",
|
|
16
|
+
"themeMode": "full",
|
|
17
|
+
"outputPath": "/path/to/output.pptx",
|
|
18
|
+
"subject": "tech"
|
|
19
|
+
},
|
|
20
|
+
"slides": [
|
|
21
|
+
{ "layout": "title", "title": "Welcome", "subtitle": "Introduction" },
|
|
22
|
+
{ "layout": "content", "title": "Key Points", "body": ["Point 1", "Point 2", "Point 3"] },
|
|
23
|
+
{ "layout": "stats", "title": "Key Metrics", "stats": [{"value": "95", "suffix": "%", "label": "Success Rate"}] },
|
|
24
|
+
{ "layout": "imageRight", "title": "Visual", "body": ["Detail 1", "Detail 2"], "image": {"path": "/path/to/image.png"} },
|
|
25
|
+
{ "layout": "closing", "title": "Thank You", "subtitle": "Questions?" }
|
|
26
|
+
]
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**🚨 FORBIDDEN — NEVER do this:**
|
|
31
|
+
```json
|
|
32
|
+
// ❌ WRONG: Empty slides array, then add slides via API one by one
|
|
33
|
+
{
|
|
34
|
+
"options": { "themePath": "...", "outputPath": "..." },
|
|
35
|
+
"slides": []
|
|
36
|
+
}
|
|
37
|
+
// Then /ppt/insert-slide → /ppt/add-text-to-slide → repeat = WRONG
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**After generation:** `/ppt/open-attach` → `/ppt/review-slides` → offer an `Agent` review (SKILL.md Core Principle 4).
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## themeMode Options
|
|
45
|
+
|
|
46
|
+
| Mode | When to use | What it does |
|
|
47
|
+
|------|-------------|-------------|
|
|
48
|
+
| `"full"` (default) | `.thmx` files, requires Office | Applies complete theme (colors, fonts, backgrounds) via PowerPoint |
|
|
49
|
+
| `"extract"` | No Office available | Extracts colors/fonts only, generates via PptxGenJS |
|
|
50
|
+
|
|
51
|
+
**`.thmx` files:** Use `themeMode: "full"` — applies the complete theme including backgrounds and slide masters.
|
|
52
|
+
|
|
53
|
+
**`.pptx` files as theme source:** Only extracts basic colors/fonts. Does NOT reproduce custom slide masters, logos, or branded layouts. If the user needs exact custom layouts preserved, use the editing/duplicate workflow instead (see SKILL.md).
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Layout Selection by Keywords
|
|
58
|
+
|
|
59
|
+
**See the full layout keywords table in SKILL.md** ("Layout Selection by Keywords" section). Scan content for keywords → select matching layout. DO NOT default everything to `content`!
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Presentation Diversity (MANDATORY)
|
|
64
|
+
|
|
65
|
+
**Every presentation MUST use at least 3 different layout types:**
|
|
66
|
+
|
|
67
|
+
| Presentation Size | Minimum Layout Variety |
|
|
68
|
+
|-------------------|------------------------|
|
|
69
|
+
| 5-7 slides | 3+ different layouts |
|
|
70
|
+
| 8-10 slides | 4+ different layouts |
|
|
71
|
+
| 11+ slides | 5+ different layouts |
|
|
72
|
+
|
|
73
|
+
**❌ BAD:** title → content → content → content → content → closing
|
|
74
|
+
**✅ GOOD:** title → content → stats → imageRight → comparison → timeline → closing
|
|
75
|
+
|
|
76
|
+
**Scan your slide plan BEFORE building - if you see 3+ consecutive `content` layouts, restructure!**
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Alternating Image Layouts
|
|
81
|
+
|
|
82
|
+
When multiple image slides: alternate `imageLeft` ↔ `imageRight` for visual variety.
|
|
83
|
+
|
|
84
|
+
```
|
|
85
|
+
Slide 3: imageRight
|
|
86
|
+
Slide 6: imageLeft ← alternated
|
|
87
|
+
Slide 9: imageRight ← alternated
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 🖼️ Image Insertion (Post-Generation Edits Only)
|
|
93
|
+
|
|
94
|
+
**Only needed if adding images AFTER generation (e.g., replacing placeholder images).**
|
|
95
|
+
|
|
96
|
+
**⚠️ ALWAYS use `targetShapeName` - omitting causes overlapping!**
|
|
97
|
+
|
|
98
|
+
```json
|
|
99
|
+
// 1. Analyze to get placeholder name
|
|
100
|
+
{"endpoint": "/ppt/analyze-slide-content", "body": {"filePath": "...", "slideNumbers": [3]}}
|
|
101
|
+
|
|
102
|
+
// 2. Insert INTO placeholder
|
|
103
|
+
{"endpoint": "/ppt/insert-image", "body": {
|
|
104
|
+
"filePath": "...", "slideNumber": 3,
|
|
105
|
+
"imagePath": "/path/to/image.png",
|
|
106
|
+
"targetShapeName": "Picture Placeholder 2"
|
|
107
|
+
}}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
**Rules:** Always analyze first → Use exact placeholder name → One image per placeholder
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## ⚠️ Common Issues & Prevention
|
|
115
|
+
|
|
116
|
+
### 1. Overlapping Text
|
|
117
|
+
**Cause:** Too much text in a placeholder
|
|
118
|
+
**Fix:** Max 5-7 bullet points per slide. Keep bullets to 1-2 lines each. Split content across multiple slides if needed.
|
|
119
|
+
|
|
120
|
+
### 2. Images Overlapping or in Wrong Position
|
|
121
|
+
**Cause:** Inserting images WITHOUT `targetShapeName` parameter
|
|
122
|
+
**Fix:** ALWAYS use `targetShapeName` in `/ppt/insert-image`. ALWAYS run `/ppt/analyze-slide-content` FIRST.
|
|
123
|
+
|
|
124
|
+
### 3. Repeating/Duplicate Text
|
|
125
|
+
**Cause:** Adding text without clearing existing content
|
|
126
|
+
**Fix:** ALWAYS use `clearExistingText: true` when replacing content.
|
|
127
|
+
|
|
128
|
+
### 4. Wrong Shape Names
|
|
129
|
+
**Cause:** Guessing shape names instead of reading them
|
|
130
|
+
**Fix:** ALWAYS run `/ppt/analyze-slide-content` BEFORE adding text. Copy shape names EXACTLY (case-sensitive).
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Quality Checklist (After Building)
|
|
135
|
+
|
|
136
|
+
Run `/ppt/review-slides` and verify:
|
|
137
|
+
- [ ] No overlapping text warnings
|
|
138
|
+
- [ ] No empty placeholder warnings
|
|
139
|
+
- [ ] All images properly positioned
|
|
140
|
+
- [ ] Consistent font sizes
|
|
141
|
+
- [ ] No duplicate content
|