@uipath/delegate-sdk 1.203.0 → 1.203.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,424 @@
|
|
|
1
|
+
# Editing Existing Presentations
|
|
2
|
+
|
|
3
|
+
This file contains the complete editing workflow for PowerPoint presentations using ExecuteSkillApi.
|
|
4
|
+
**Loaded on demand from SKILL.md when editing an existing presentation.**
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Part 2: Editing Existing Presentations (ExecuteSkillApi)
|
|
9
|
+
|
|
10
|
+
Use **ExecuteSkillApi** with `/ppt/*` endpoints when editing existing presentations. Requires PowerPoint to be installed.
|
|
11
|
+
|
|
12
|
+
### Execution Strategy
|
|
13
|
+
|
|
14
|
+
| Priority | Approach | Speed | Best For |
|
|
15
|
+
|----------|----------|-------|----------|
|
|
16
|
+
| **1st** | ExecuteSkillApi | Fastest | All presentation edits, text, images, charts |
|
|
17
|
+
| **2nd** | C# Script (Windows only — `/ppt/execute-script` doesn't exist on macOS) | Fast | Complex logic, custom automation |
|
|
18
|
+
| **3rd** | UIA (AppAct) | Slowest | Ribbon clicks, dialogs, animations |
|
|
19
|
+
|
|
20
|
+
If the user forbids arbitrary Office scripts, never call `/ppt/execute-script`. Use structured `/ppt/*` endpoints or report the limitation.
|
|
21
|
+
|
|
22
|
+
### Fallback Strategy (MANDATORY)
|
|
23
|
+
|
|
24
|
+
**Windows: if ExecuteSkillApi or C# Script fails 2 consecutive times for the same operation, fall back to UIA (AppAct). macOS: if ExecuteSkillApi fails 2 consecutive times, fall back to UIA (AppAct) — there is no C# Script step.**
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
Attempt 1: ExecuteSkillApi → fails
|
|
28
|
+
Attempt 2: ExecuteSkillApi → fails
|
|
29
|
+
Attempt 3: Switch to UIA (AppAct)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
**When to use UIA fallback:**
|
|
33
|
+
- COM automation fails repeatedly (locked UI, modal dialogs, etc.)
|
|
34
|
+
- Shape/placeholder not found despite correct name
|
|
35
|
+
- PowerPoint not responding to API calls
|
|
36
|
+
- Clipboard operations failing
|
|
37
|
+
|
|
38
|
+
**UIA can handle:**
|
|
39
|
+
- Clicking ribbon buttons and menus
|
|
40
|
+
- Navigating dialogs and prompts
|
|
41
|
+
- Direct keyboard input (Ctrl+C, Ctrl+V, etc.)
|
|
42
|
+
- Visual element interaction when COM fails
|
|
43
|
+
|
|
44
|
+
**Important:**
|
|
45
|
+
- UIA is slower but more reliable for edge cases. Don't skip directly to UIA - always try the faster approaches first.
|
|
46
|
+
- **Fallback is per-operation, not permanent.** After using UIA for one operation, try ExecuteSkillApi/Script again for the NEXT different operation. Only fall back to UIA again if that new operation also fails 2 times.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Discovery-First Workflow (CRITICAL)
|
|
51
|
+
|
|
52
|
+
Before editing, ALWAYS discover the presentation structure:
|
|
53
|
+
|
|
54
|
+
```
|
|
55
|
+
1. Open/Attach -> Get file reference and slide list
|
|
56
|
+
2. Analyze -> Get shape names and layout for target slide(s)
|
|
57
|
+
3. Plan -> Determine what changes to make
|
|
58
|
+
4. Execute -> Perform operations using exact shape names
|
|
59
|
+
5. Verify -> /ppt/review-slides, then offer a content review (see Health Check & Review below)
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**Why Discovery Matters:**
|
|
63
|
+
- Shape names vary between presentations and templates
|
|
64
|
+
- Using wrong shape name = operation fails silently
|
|
65
|
+
- Prevents overwriting unintended content
|
|
66
|
+
- Health check catches layout issues, overlaps, and formatting problems
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Critical Rules
|
|
71
|
+
|
|
72
|
+
| Rule | Description |
|
|
73
|
+
|------|-------------|
|
|
74
|
+
| **Open first** | Always call `/ppt/open-attach` before any operation |
|
|
75
|
+
| **Analyze before edit** | Call `/ppt/analyze-slide-content` to get shape names before editing a slide for the first time |
|
|
76
|
+
| **Use exact shape names** | Copy shape names exactly from analyze response |
|
|
77
|
+
| **Extract via API** | Use `/ppt/extract-slide-data` for tables/text/charts - NEVER scripts |
|
|
78
|
+
| **clearExistingText: true** | Windows: ALWAYS use `clearExistingText: true` when replacing content to prevent doubling. macOS: `add-text-to-slide` always replaces; the flag is ignored. |
|
|
79
|
+
| **Health check + fix** | Run `/ppt/review-slides` and fix what it reports in one pass before declaring success (SKILL.md Core Principle 4) |
|
|
80
|
+
| **Auto-save enabled** | Changes save automatically, no explicit save needed |
|
|
81
|
+
| **Slide numbers are 1-based** | First slide = 1, not 0 |
|
|
82
|
+
| **No emoji in table data (macOS)** | On macOS, emoji characters (✅, ⚠️, ❌, etc.) in table cells render as "A" or "Aa" due to encoding issues. Use text alternatives instead: YES/NO/PARTIAL, or symbols like [+], [-], [~] |
|
|
83
|
+
|
|
84
|
+
## Emoji / Unicode in Tables (macOS)
|
|
85
|
+
|
|
86
|
+
**On macOS, NEVER use emoji characters in table cell data.** Emoji like ✅ ⚠️ ❌ get corrupted during insertion and render as "A" or "Aa" — this is a known AppleScript/PowerPoint encoding limitation.
|
|
87
|
+
|
|
88
|
+
**Use text alternatives instead:**
|
|
89
|
+
| Instead of | Use |
|
|
90
|
+
|------------|-----|
|
|
91
|
+
| ✅ | `YES` or `[+]` or `SUPPORTED` |
|
|
92
|
+
| ❌ | `NO` or `[-]` or `NOT SUPPORTED` |
|
|
93
|
+
| ⚠️ | `PARTIAL` or `[~]` or `LIMITED` |
|
|
94
|
+
|
|
95
|
+
This applies to `/ppt/insert-table` data on macOS. Text in regular shapes (titles, content placeholders) is not affected.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Standard Slide Layouts
|
|
100
|
+
|
|
101
|
+
**Use these layout names with `/ppt/insert-slide`:**
|
|
102
|
+
|
|
103
|
+
| Layout Name | Use For | Placeholders |
|
|
104
|
+
|-------------|---------|--------------|
|
|
105
|
+
| `Title Slide` | Opening/closing slides | Title 1, Subtitle 2 |
|
|
106
|
+
| `Title and Content` | Standard content slides | Title 1, Content Placeholder 2 |
|
|
107
|
+
| `Two Content` | Side-by-side content | Title 1, Content Placeholder 2, Content Placeholder 3 |
|
|
108
|
+
| `Comparison` | vs/comparison content | Title 1, Text Placeholder 2, Text Placeholder 3 |
|
|
109
|
+
| `Title Only` | Slides with charts/images | Title 1 |
|
|
110
|
+
| `Blank` | Full image or custom layout | (none) |
|
|
111
|
+
| `Section Header` | Section dividers | Title 1, Text Placeholder 2 |
|
|
112
|
+
| `Content with Caption` | Image + description | Title 1, Content Placeholder 2, Text Placeholder 3 |
|
|
113
|
+
| `Picture with Caption` | Single image + caption | Title 1, Picture Placeholder 2, Text Placeholder 3 |
|
|
114
|
+
|
|
115
|
+
**The API has smart fallback:** If layout doesn't exist in theme, it will try fuzzy matching then standard fallbacks.
|
|
116
|
+
|
|
117
|
+
**For custom themes:** Request the layout type you need - the API handles finding the best match.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Content Replacement (CRITICAL - Prevent Doubling)
|
|
122
|
+
|
|
123
|
+
**Windows:** ALWAYS use `clearExistingText: true` when replacing content to prevent doubling.
|
|
124
|
+
|
|
125
|
+
**macOS:** `add-text-to-slide` always replaces shape content — it never appends, regardless of `clearExistingText`. Doubling can't happen, but intentional appending also isn't possible; use a separate shape or `/ppt/add-html-to-slide` to build combined content instead.
|
|
126
|
+
|
|
127
|
+
The rest of this section (examples, when to use `clearExistingText`) describes Windows behavior.
|
|
128
|
+
|
|
129
|
+
When you add text to a shape that already has content on Windows, the new text is **APPENDED** by default. This causes content to double.
|
|
130
|
+
|
|
131
|
+
**❌ WRONG - causes doubling:**
|
|
132
|
+
```json
|
|
133
|
+
{ "endpoint": "/ppt/add-text-to-slide", "body": {
|
|
134
|
+
"filePath": "C:/presentation.pptx",
|
|
135
|
+
"slideNumber": 3,
|
|
136
|
+
"targetShapeName": "Content Placeholder 2",
|
|
137
|
+
"text": "New content"
|
|
138
|
+
// Missing clearExistingText!
|
|
139
|
+
}}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**✅ CORRECT - replaces content:**
|
|
143
|
+
```json
|
|
144
|
+
{ "endpoint": "/ppt/add-text-to-slide", "body": {
|
|
145
|
+
"filePath": "C:/presentation.pptx",
|
|
146
|
+
"slideNumber": 3,
|
|
147
|
+
"targetShapeName": "Content Placeholder 2",
|
|
148
|
+
"text": "New content",
|
|
149
|
+
"clearExistingText": true
|
|
150
|
+
}}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
**When to use `clearExistingText: true`:**
|
|
154
|
+
- Replacing slide content with new content
|
|
155
|
+
- Fixing content issues found by health check
|
|
156
|
+
- Updating existing bullet points
|
|
157
|
+
- Re-adding text after stripping bullet characters
|
|
158
|
+
|
|
159
|
+
**When to OMIT it (rare):**
|
|
160
|
+
- Intentionally appending to existing content (ask user first)
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Seamless Create-to-Edit Workflow
|
|
165
|
+
|
|
166
|
+
```
|
|
167
|
+
1. CREATE -> Generator creates .pptx file
|
|
168
|
+
2. OPEN -> /ppt/open-attach (windowless unless the user asked to see the deck)
|
|
169
|
+
3. ANALYZE -> /ppt/analyze-slide-content (if edits needed)
|
|
170
|
+
4. EDIT -> /ppt/* endpoints
|
|
171
|
+
5. VERIFY -> /ppt/review-slides, then offer an Agent review
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
### Example: Create then Edit
|
|
175
|
+
|
|
176
|
+
```
|
|
177
|
+
// Step 1: Create the presentation with generator
|
|
178
|
+
ExecuteSkillApi:
|
|
179
|
+
endpoint: "/ppt-gen/generate"
|
|
180
|
+
body: { "options": {...}, "slides": [...] }
|
|
181
|
+
toolName: "Generate Presentation"
|
|
182
|
+
description: "Creating the presentation from scratch"
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
```json
|
|
186
|
+
// Step 2: Open in PowerPoint
|
|
187
|
+
{
|
|
188
|
+
"endpoint": "/ppt/open-attach",
|
|
189
|
+
"body": {
|
|
190
|
+
"filePath": "C:/Users/me/Documents/Q4_Review.pptx"
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
// Step 3: Analyze slide 2 to get shape names
|
|
195
|
+
{
|
|
196
|
+
"endpoint": "/ppt/analyze-slide-content",
|
|
197
|
+
"body": {
|
|
198
|
+
"filePath": "C:/Users/me/Documents/Q4_Review.pptx",
|
|
199
|
+
"slideNumbers": [2]
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
// Response: { "slides": [{ "slideNumber": 2, "shapeNames": ["Title 1", "Content Placeholder 2"] }] }
|
|
203
|
+
|
|
204
|
+
// Step 4: Add text to the slide
|
|
205
|
+
{
|
|
206
|
+
"endpoint": "/ppt/add-text-to-slide",
|
|
207
|
+
"body": {
|
|
208
|
+
"filePath": "C:/Users/me/Documents/Q4_Review.pptx",
|
|
209
|
+
"slideNumber": 2,
|
|
210
|
+
"targetShapeName": "Content Placeholder 2",
|
|
211
|
+
"text": "- Key finding 1\n- Key finding 2\n- Key finding 3"
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// Step 5: Health check (then offer an Agent review)
|
|
216
|
+
{
|
|
217
|
+
"endpoint": "/ppt/review-slides",
|
|
218
|
+
"body": {
|
|
219
|
+
"filePath": "C:/Users/me/Documents/Q4_Review.pptx"
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
// Response includes diagnostic info - YOU decide how to fix based on context
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
## Health Check (AUTOMATIC) & Review (ASK USER)
|
|
228
|
+
|
|
229
|
+
### Health Check - Always Run Automatically
|
|
230
|
+
**After creating/editing presentations, ALWAYS run the health check yourself:**
|
|
231
|
+
```json
|
|
232
|
+
endpoint: "/ppt/review-slides"
|
|
233
|
+
body: { "filePath": "..." }
|
|
234
|
+
```
|
|
235
|
+
This catches technical issues: overlapping shapes, out of bounds, empty placeholders, text overflow, double bullets, font hierarchy, empty lines.
|
|
236
|
+
- **If issues found** → Fix them yourself using `issue-fix-mapping.md` in the one corrective pass (SKILL.md Core Principle 4); if the user asked for a content review, run it first and fix both in that pass. Re-run once and report what remains.
|
|
237
|
+
- **No issues** → Proceed to ask about full review
|
|
238
|
+
|
|
239
|
+
### Full Review - Ask User First
|
|
240
|
+
**For non-trivial presentations: ASK the user if they want a full review via `Agent` with `agent_type: "review"`.** If the user already asked for a review, run it now without asking.
|
|
241
|
+
|
|
242
|
+
Trivial = ≤2 slides with simple bullet content.
|
|
243
|
+
|
|
244
|
+
**After health check passes, ask the user:**
|
|
245
|
+
"Would you like me to do a full content review of the presentation before we're done?"
|
|
246
|
+
- If user says yes → call `Agent` with `agent_type: "review"`
|
|
247
|
+
- If user says no or wants to skip → inform user the presentation is ready
|
|
248
|
+
|
|
249
|
+
**The Agent review runs these additional checks:**
|
|
250
|
+
1. **Content Review**: Accuracy, visual consistency, spelling, slide flow
|
|
251
|
+
2. **Fact-check** via WebSearch if presentation contains claims
|
|
252
|
+
|
|
253
|
+
**After the Agent review completes:** its blocking findings join the request's one corrective pass (SKILL.md Core Principle 4), together with any open health-check findings; re-check only the changed slides. Fix them with `issue-fix-mapping.md`, report minor ones to the user. Do not start another full review unless the user asks for one.
|
|
254
|
+
|
|
255
|
+
📄 **Fix patterns**: Load `<skill-path>/issue-fix-mapping.md` for detailed fixes.
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
### Issue → Fix Mapping (Load When Fixing Issues)
|
|
260
|
+
|
|
261
|
+
**📄 Load `<skill-path>/issue-fix-mapping.md` when you need to fix health check issues.**
|
|
262
|
+
|
|
263
|
+
This separate file contains detailed fix patterns for every issue type:
|
|
264
|
+
- **STYLING ISSUES**: Double bullets, underline, subtitle formatting, empty lines, bullet counts, font hierarchy
|
|
265
|
+
- **TEXT ISSUES**: Small fonts, empty placeholders, template text
|
|
266
|
+
- **LAYOUT ISSUES**: Overlapping shapes, out of bounds, text overflow, empty slides
|
|
267
|
+
- **CONTENT ISSUES**: Empty tables
|
|
268
|
+
- **FORMATTING ISSUES**: Font consistency
|
|
269
|
+
- **IMAGE ISSUES**: Broken linked images
|
|
270
|
+
|
|
271
|
+
**Quick Reference (most common):**
|
|
272
|
+
|
|
273
|
+
| Issue | Quick Fix |
|
|
274
|
+
|-------|-----------|
|
|
275
|
+
| Double bullets | Re-add text without leading `- ` or `• ` chars, use `clearExistingText: true` |
|
|
276
|
+
| Subtitle not bold | `/ppt/format-slide-content` with `bold: true` |
|
|
277
|
+
| Font too small | `/ppt/format-slide-content` with `fontSize: 18` (min 14pt) |
|
|
278
|
+
| Text overflow | `/ppt/format-slide-content` with smaller `fontSize` |
|
|
279
|
+
| Empty placeholder | Windows: `/ppt/optimize-slide` with `deleteEmpty: true`. macOS: the delete half is not supported — the autofit runs and a `warning` says nothing was removed; hide the placeholder with `/ppt/format-shape` `visible: false`, or leave it empty |
|
|
280
|
+
| Overlapping shapes | `/ppt/format-shape` with new `left`/`top` position |
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
### Health Check Response
|
|
285
|
+
|
|
286
|
+
```json
|
|
287
|
+
{
|
|
288
|
+
"success": true,
|
|
289
|
+
"review": {
|
|
290
|
+
"summary": {
|
|
291
|
+
"totalSlides": 10,
|
|
292
|
+
"slidesReviewed": 10,
|
|
293
|
+
"issuesFound": 3,
|
|
294
|
+
"warningsFound": 2,
|
|
295
|
+
"criticalIssues": 1
|
|
296
|
+
},
|
|
297
|
+
"slides": [
|
|
298
|
+
{
|
|
299
|
+
"slideNumber": 2,
|
|
300
|
+
"issues": [
|
|
301
|
+
{
|
|
302
|
+
"severity": "warning",
|
|
303
|
+
"category": "layout",
|
|
304
|
+
"message": "Shape overlaps with another shape",
|
|
305
|
+
"shapeName": "TextBox 1",
|
|
306
|
+
"recommendation": "Move or resize the shape"
|
|
307
|
+
}
|
|
308
|
+
]
|
|
309
|
+
}
|
|
310
|
+
],
|
|
311
|
+
"recommendations": ["Fix overlapping shapes on slide 2"]
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
## Common Editing Workflows
|
|
317
|
+
|
|
318
|
+
**📄 Load `<skill-path>/windows/examples/level-1-workflows.md` for detailed workflow examples.**
|
|
319
|
+
|
|
320
|
+
Contains step-by-step patterns for:
|
|
321
|
+
- Create presentation from scratch
|
|
322
|
+
- Edit existing presentation
|
|
323
|
+
- Duplicate and modify slides (template pattern)
|
|
324
|
+
- Insert tables and charts
|
|
325
|
+
- Extract data (ALWAYS use `/ppt/extract-slide-data`, NOT scripts)
|
|
326
|
+
- Apply theme and format
|
|
327
|
+
|
|
328
|
+
**Quick patterns:**
|
|
329
|
+
|
|
330
|
+
| Task | Key Steps |
|
|
331
|
+
|------|-----------|
|
|
332
|
+
| Edit slide | Open → Analyze → Add text with `clearExistingText: true` → Health check → offer Agent review |
|
|
333
|
+
| Insert slide (custom theme) | Open → Insert → Add title/content → Health check → offer Agent review |
|
|
334
|
+
| Insert slide (no custom theme) | Open → Duplicate closest matching slide → Replace content with `clearExistingText: true` → Health check → offer Agent review |
|
|
335
|
+
| Duplicate slides | Duplicate → Modify ONLY what changes (content already copied!) → Health check → offer Agent review of new slide|
|
|
336
|
+
| Extract data | Use `/ppt/extract-slide-data` (NEVER scripts) |
|
|
337
|
+
| Add image | `/ppt/insert-image` — Windows: use `targetShapeName` for placeholders, or `left`/`top`/`width` for free positioning. macOS: `targetShapeName` isn't supported (smart positioning is used instead, with a `warning` in the response); use `left`/`top`/`width` for exact placement |
|
|
338
|
+
| Apply theme (editing) | `/ppt/apply-theme` (for creation use `themePath` in generator) → Health check → offer Agent review of theme|
|
|
339
|
+
|
|
340
|
+
---
|
|
341
|
+
|
|
342
|
+
## Theme Detection & Slide Insertion Strategy
|
|
343
|
+
|
|
344
|
+
`/ppt/get-presentation-info` returns `themeName` and optionally `themeWarning`.
|
|
345
|
+
|
|
346
|
+
### Why This Matters
|
|
347
|
+
|
|
348
|
+
Many presentations have visual styling (colors, fonts, backgrounds) applied manually or via a template — but no real PowerPoint theme. The underlying theme is still "Office Theme". When you insert a new slide with `/ppt/insert-slide`, it inherits from the **theme**, not from the existing slides. Result: a plain white/black slide that breaks visual consistency.
|
|
349
|
+
|
|
350
|
+
### Decision Rule
|
|
351
|
+
|
|
352
|
+
After calling `/ppt/get-presentation-info`, check if `themeWarning` is present:
|
|
353
|
+
|
|
354
|
+
| `themeWarning` | Slide insertion strategy |
|
|
355
|
+
|---|---|
|
|
356
|
+
| absent | `/ppt/insert-slide` is safe — new slides inherit the theme's styling |
|
|
357
|
+
| present | **MUST** use duplicate-slide + replace content (not insert-slide) |
|
|
358
|
+
|
|
359
|
+
### Workflow When `themeWarning` is present
|
|
360
|
+
|
|
361
|
+
1. Identify the existing slide whose layout/styling best matches what you need
|
|
362
|
+
2. Duplicate it: `/ppt/duplicate-slides` with `startSlideNumber` of that slide
|
|
363
|
+
3. Replace content on the duplicated slide using `/ppt/add-text-to-slide` with `clearExistingText: true`
|
|
364
|
+
4. Update images with `/ppt/replace-image` or `/ppt/insert-image` as needed
|
|
365
|
+
|
|
366
|
+
**Edge case:** If the presentation has 0 slides, `/ppt/insert-slide` is the only option (nothing to duplicate).
|
|
367
|
+
|
|
368
|
+
---
|
|
369
|
+
|
|
370
|
+
## Match Existing Styling (MANDATORY when editing generated presentations)
|
|
371
|
+
|
|
372
|
+
Generated presentations use theme-specific fonts/sizes/colors. Before editing:
|
|
373
|
+
1. `/ppt/analyze-slide-content` on a nearby slide → note font, size, color
|
|
374
|
+
2. When replacing text: match font/size/color exactly from analyze response
|
|
375
|
+
3. When duplicating slides: only change content, keep formatting
|
|
376
|
+
4. When inserting slides: copy font/size/color from existing slides of same layout type
|
|
377
|
+
|
|
378
|
+
Do NOT use default PowerPoint fonts when the deck uses generator styling.
|
|
379
|
+
|
|
380
|
+
---
|
|
381
|
+
|
|
382
|
+
## Best Practices for Editing (ExecuteSkillApi) - MANDATORY
|
|
383
|
+
|
|
384
|
+
1. **Always open first** - Call `/ppt/open-attach` before any other endpoint
|
|
385
|
+
2. **Analyze before first edit** - Get shape names before modifying a slide for the first time
|
|
386
|
+
3. **Use exact shape names** - Copy them exactly from analyze response
|
|
387
|
+
4. **Shape names are case-sensitive** - "Title 1" != "title 1"
|
|
388
|
+
5. **Remove bullet chars from text** - if shape has bullet formatting, don't add "- " or "• "
|
|
389
|
+
6. **Check font hierarchy** - titles must be larger than body text
|
|
390
|
+
7. **Match existing styling** - inspect nearby slides for font/size/color before adding content (see section above)
|
|
391
|
+
8. **Verify once, then hand over** - SKILL.md Core Principle 4
|
|
392
|
+
9. **Auto-save is enabled** - Changes persist automatically
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## Troubleshooting
|
|
397
|
+
|
|
398
|
+
| Error | Cause | Solution |
|
|
399
|
+
|-------|-------|----------|
|
|
400
|
+
| `File already exists` | Generator output path exists | Use different filename or delete existing |
|
|
401
|
+
| `Shape not found` | Wrong shape name | Run `/ppt/analyze-slide-content` to get exact names |
|
|
402
|
+
| `No active presentation` | File not open | Call `/ppt/open-attach` first |
|
|
403
|
+
| `Module not found` | pptxgenjs not loaded | Ensure using ExecuteSkillApi with `/ppt-gen/*` endpoints |
|
|
404
|
+
| `Slide not found` | Invalid slide number | Slide numbers are 1-based (first slide = 1) |
|
|
405
|
+
|
|
406
|
+
---
|
|
407
|
+
|
|
408
|
+
## Charts with Dark Themes (Auto-Handled)
|
|
409
|
+
|
|
410
|
+
**Background:** Charts don't inherit PowerPoint theme text colors - they historically used default black text regardless of background.
|
|
411
|
+
|
|
412
|
+
**Good News - Now Auto-Fixed on Windows:**
|
|
413
|
+
|
|
414
|
+
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):
|
|
415
|
+
|
|
416
|
+
- **Dark backgrounds** (luminance < 50%): White text is applied automatically
|
|
417
|
+
- **Light backgrounds** (luminance >= 50%): Black text is applied automatically
|
|
418
|
+
|
|
419
|
+
**Workflow (Simplified):**
|
|
420
|
+
1. `/ppt/insert-chart` - Insert the chart (colors auto-adjusted based on background)
|
|
421
|
+
2. `/ppt/review-slides` - Verify visibility
|
|
422
|
+
|
|
423
|
+
**Manual Override (if needed, Windows only):**
|
|
424
|
+
If you need custom colors, use `/ppt/execute-script` with C# code to set specific chart text colors. `/ppt/execute-script` doesn't exist on macOS — recreate the chart with different insert-chart parameters instead.
|