@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,853 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: powerpoint-architect
|
|
3
|
+
friendly_name: PowerPoint Architect
|
|
4
|
+
icon: powerpoint
|
|
5
|
+
color: "#D24726"
|
|
6
|
+
description: Comprehensive PowerPoint automation skillset for professional presentations. Use this when the user needs to create, edit, format, or analyze presentations.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# PowerPoint Architect - Common Patterns
|
|
10
|
+
|
|
11
|
+
This document contains platform-independent PowerPoint guidance. Platform-specific APIs are loaded separately based on your operating system.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Large generate payloads → `bodyFromFile`
|
|
16
|
+
|
|
17
|
+
For `/ppt-gen/generate` with > 12 slides or > ~3500 tokens of inline JSON: put the spec on disk, pass the path. Don't inline, don't pre-draft in `<thinking>`.
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{ "operations": [{ "endpoint": "/ppt-gen/generate", "bodyFromFile": "/tmp/deck.json" }],
|
|
21
|
+
"toolName": "Generate Deck", "description": "..." }
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Executor reads the file. Don't `ReadFile` it back.
|
|
25
|
+
|
|
26
|
+
**The `bodyFromFile` path MUST be under the OS temp dir** — Windows `%TEMP%\...` (= `C:\Users\<user>\AppData\Local\Temp\...`), macOS/Linux `/tmp/...`. NEVER write the spec to Documents, Desktop, Downloads, or any other user folder. (`outputPath`, `themePath`, and other user-facing files DO go to user folders — this rule is only for the internal `bodyFromFile` spec.) The executor auto-deletes temp spec files after a successful call; files outside temp linger forever and clutter the user's machine.
|
|
27
|
+
|
|
28
|
+
**Use a unique filename per run.** Suffix with a timestamp or short tag — e.g. `/tmp/deck-1714838400.json`, `%TEMP%\deck-1714838400.json`, `/tmp/build-deck-1714838400.js`. Reusing the same name (`deck.json`, `build-deck.js`) collides with leftover files from previous runs.
|
|
29
|
+
|
|
30
|
+
**Never expose internal terminology to the user — anywhere in chat, ever.** Forbidden list: `bodyFromFile`, `JSON`, `Node script`, `spec`, `payload`, `temp file`, `inline body`, `WriteFile`, `ExecuteSkillApi`, `endpoint`, `staging`, `payload limits`. The user asked for a deck; they don't need to know HOW it gets built. **Never ask the user to choose between implementation paths** ("should I draft a script?", "do you want bodyFromFile?") — you decide silently. The only acceptable user-facing chat about the build is one short plain-language status update: *"Setting up your slides."* / *"Building it now."* / *"Putting the deck together."*
|
|
31
|
+
|
|
32
|
+
Two ways — pick by shape:
|
|
33
|
+
|
|
34
|
+
1. **Static deck** (each slide hand-authored, no repetition): `WriteFile` JSON straight to `/tmp/deck.json` (`%TEMP%\deck.json` on Windows).
|
|
35
|
+
2. **Repetitive/programmatic** (data slides from rows, agenda items, looped layouts): `WriteFile` a Node script `/tmp/build-deck.js` that builds `{ options, slides }`, then `ExecuteBashCommand` → `node /tmp/build-deck.js > /tmp/deck.json`.
|
|
36
|
+
|
|
37
|
+
Tweak `outputPath`/`theme` without rewriting → `bodyFromFile` + small inline `body`; inline wins on collision.
|
|
38
|
+
|
|
39
|
+
≤ 12 simple slides → build inline.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## ⚠️ Platform Availability
|
|
44
|
+
|
|
45
|
+
| Platform | Creation (Generator) | Editing |
|
|
46
|
+
|----------|---------------------|---------|
|
|
47
|
+
| **Windows** | ✅ PowerPoint Generator | ✅ ExecuteSkillApi (`/ppt/*` endpoints), UIA fallback |
|
|
48
|
+
| **macOS** | ✅ PowerPoint Generator | ✅ ExecuteSkillApi (`/ppt/*` endpoints), UIA fallback |
|
|
49
|
+
|
|
50
|
+
**✅ macOS Support:** ExecuteSkillApi (`/ppt/*` endpoints) is available on macOS through AppleScript-backed handlers. Editing is supported on both platforms, but endpoint sets and save behavior differ. Follow the loaded platform reference. If API calls fail 2 consecutive times, fall back to UIA (AppAct/AppFind).
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Core Principles
|
|
55
|
+
|
|
56
|
+
0. **NEVER make PowerPoint visible unless the user asked.** `visible: true` on `/ppt/open-attach` is for one situation only: the user said to open, show, or look at the deck. Do not pass it because an operation failed, because it worked before, or because you want to check your work. If an operation fails windowless, re-read the exceptions table below rather than reaching for a window: it lists every endpoint that genuinely needs one, and nothing outside that list is fixed by making the deck visible. Making a deck visible is irreversible for that deck.
|
|
57
|
+
1. **API-First, UIA as Fallback**: Use ExecuteSkillApi for all operations on both Windows and macOS. Follow the loaded platform reference for available `/ppt/*` endpoints. Fall back to UIA (AppAct) after 2 consecutive failures. **Hard limit: if any action (API or UIA) fails 3 times with the same or similar error, STOP and switch to a fundamentally different approach. Never repeat a failing action more than 3 times.**
|
|
58
|
+
2. **Visual Verification**: Never trust "success" messages alone. Because the deck is windowless there is nothing on screen to screenshot, so read the rendered slides instead: `ReadFile` on the `.pptx` returns one image per slide. Those images are pixel-identical to what the user sees when they open the file.
|
|
59
|
+
3. **Slide by Slide (EDITING ONLY — NOT for generation)**: When EDITING an existing presentation, build and verify each slide before proceeding to the next. Insert one slide → add its content → verify → then insert the next slide. **This does NOT apply to the Generator** — the Generator creates ALL slides with ALL content in ONE call. NEVER create an empty/minimal presentation with the Generator and then add slides one by one via API.
|
|
60
|
+
4. **Verify once, then hand over**: After creation/editing, run `/ppt/review-slides`; if the user already asked for a content review, delegate it too, without asking. Fix what they report in one corrective pass (below), then hand the deck over. If no review was requested, ask whether the user wants one. A content review is always `Agent` with `agent_type: "review"`, never yourself.
|
|
61
|
+
- **Convergence:** one corrective pass per request. Collect the blocking findings from the health check, your own render check (Core Principle 2) and the content review, fix them together in that one pass (at most one regeneration), then re-check only the changed slides: `/ppt/review-slides`, plus `ReadFile` of the deck for content or readability fixes. Anything still wrong or newly found after that pass is reported, not fixed again. Do not repeat a full check or run a second full review unless the user asks.
|
|
62
|
+
- **Requested edits come first:** the corrective pass follows every change the user asked for; checking each slide while you make them is part of the edit. Stopping applies to corrective changes, never to edits the user asked for.
|
|
63
|
+
- **Regenerate in place:** `/ppt/close` the open deck, then rebuild the same `outputPath`; overwriting the deck you built for this request is expected. Never save versioned or backup copies (`-v2`, `-fixed`, `-final`, `-backup`) unless the user asks.
|
|
64
|
+
- **Stop after the corrective pass:** do not change the deck again by any path (generator, `/ppt/*` edits, UI automation, scripts); hand it over and list what is still wrong. The generator refuses a third build of the same deck in one request, and a copy with a version or fix suffix (`-v2`, ` (1)`, `-fixed`) counts as that deck; give each requested deck its own name.
|
|
65
|
+
- **Blocking:** missing or wrong content, clipped or overflowing text, blank or unreadable slides. **Minor:** wording, density, spacing, layout taste that hides no content. Minor findings never block handoff; list them for the user. A blocking issue still present after the corrective pass → report it and hand over the latest usable deck.
|
|
66
|
+
5. **Reference-Driven Quality**: When a reference presentation exists, match its visual patterns exactly.
|
|
67
|
+
6. **ALWAYS Add Images**: Every presentation MUST include images on at least 2-3 slides. Search or generate images BEFORE building slides. Never create a presentation without images, unless the user requires it.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Diagrams
|
|
72
|
+
|
|
73
|
+
Use the Generator `diagram` layout or `/diagram/render-mermaid` endpoint to render Mermaid diagrams (architecture, flowcharts, sequence, etc.) as high-res PNG images.
|
|
74
|
+
|
|
75
|
+
**New presentations:** Use `layout: "diagram"` in the Generator JSON. The diagram code is Mermaid; the renderer is invoked automatically and the PNG is placed on the slide.
|
|
76
|
+
|
|
77
|
+
**Existing presentations:** Call `/diagram/render-mermaid` with `{ code, outputPath? }` (Mermaid source) to get a PNG file path, then use `/ppt/insert-image` to place it on a slide.
|
|
78
|
+
|
|
79
|
+
**Tips for presentation-quality diagrams:**
|
|
80
|
+
- Keep node labels short (3-5 words max)
|
|
81
|
+
- Limit to 8-12 nodes (slides must be readable at a distance)
|
|
82
|
+
- Use subgraphs to group related components
|
|
83
|
+
- Diagram colors inherit from the presentation theme automatically
|
|
84
|
+
|
|
85
|
+
**Do NOT** attempt to create diagrams by inserting shapes one-by-one via `/ppt/insert-shape` or scripts.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Known Limitations
|
|
90
|
+
|
|
91
|
+
| Area | Rule |
|
|
92
|
+
|------|------|
|
|
93
|
+
| **Editable diagrams** | Diagrams are inserted as images (not editable shapes). Use the `diagram` layout for visual diagrams. Do NOT attempt one-by-one shape insertion via scripts. |
|
|
94
|
+
| **SmartArt via UIA** | NEVER populate SmartArt text via AppAct. The text pane X button closes PowerPoint, and text does not persist. Windows: use `/ppt/execute-script` only. macOS: `/ppt/execute-script` does not exist — use regular shapes instead. |
|
|
95
|
+
| **OneDrive files** | Script-created shapes may not persist due to sync conflicts. On macOS, call `/ppt/save-presentation` after script modifications. Windows structured mutations auto-save and have no `/ppt/save-presentation` endpoint. If sync fails, save to a local path first. |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Windowless by Default — Do NOT Show PowerPoint
|
|
100
|
+
|
|
101
|
+
**`/ppt/open-attach` opens the deck without a PowerPoint window.** You build, edit, and review it while the user sees nothing. This is the default and it is what the user wants: do not narrate it, and do not "helpfully" open the deck to show your work.
|
|
102
|
+
|
|
103
|
+
**Only pass `"visible": true` when the user explicitly asks to see it** ("open it", "show me the deck", "let me look at it"). Then, and only then:
|
|
104
|
+
|
|
105
|
+
```json
|
|
106
|
+
{ "endpoint": "/ppt/open-attach", "body": { "filePath": "C:\\...\\deck.pptx", "visible": true } }
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
A deck the user already had open in PowerPoint stays visible either way, you attach to their window rather than hiding it.
|
|
110
|
+
|
|
111
|
+
**Making a deck visible is one-way.** Closing a presentation's only window closes the presentation, so there is no way back to windowless. Never pass `"visible": true` speculatively.
|
|
112
|
+
|
|
113
|
+
### Operations that need a visible window
|
|
114
|
+
|
|
115
|
+
These require `"visible": true` and fail otherwise. They are the only exceptions:
|
|
116
|
+
|
|
117
|
+
| Endpoint | Why |
|
|
118
|
+
|---|---|
|
|
119
|
+
| `/ppt/select-slide` | Navigates a window. Pointless with nothing on screen, so **just skip it** in the default flow |
|
|
120
|
+
| `/ppt/get-current-slide-number` | No window means no current slide |
|
|
121
|
+
| `/ppt/insert-chart` | Embeds a live Excel workbook, which needs a window |
|
|
122
|
+
|
|
123
|
+
Everything else works windowless, including `/ppt/insert-table` and `/ppt/get-opened-files`.
|
|
124
|
+
|
|
125
|
+
**Charts and the two generator paths.** A built-in theme is written entirely by PptxGenJS, so `layout: "chart"` produces a real native chart with no PowerPoint involved and nothing on screen. A **custom template** (`themePath`) builds its slides inside PowerPoint against the template's own layouts, so its charts go through `/ppt/insert-chart` and need a window. The generator detects chart slides up front and builds that one deck visibly rather than silently degrading the chart, so **a themed deck containing a chart is the one case where a window appears without the user asking**. Say so if it happens.
|
|
126
|
+
|
|
127
|
+
**Computer use (`AppFind`/`AppAct`) on a deck also needs `visible: true`.** UIA drives a real window, so there is nothing for it to find or type into otherwise. If a task genuinely requires driving PowerPoint's UI (a ribbon command with no API), open that deck visibly and say why.
|
|
128
|
+
|
|
129
|
+
**Charts:** build them with the Generator (`layout: "chart"`). On a built-in theme that needs no PowerPoint at all; on a custom template the generator handles the window itself. Only reach for `/ppt/insert-chart` directly when adding a chart to an *existing* deck, and expect to make it visible first.
|
|
130
|
+
|
|
131
|
+
`/ppt/get-presentation-info` works windowless, so the theme gate below is unaffected.
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Release the deck when you're done
|
|
136
|
+
|
|
137
|
+
**An open deck stays locked.** Every `/ppt/*` call opens the deck and keeps it open, `/ppt/review-slides` included. Until it is closed, the file is "used by another process" for other tools, and the user who opens it sees no window: PowerPoint hands them the hidden copy.
|
|
138
|
+
|
|
139
|
+
End a task with `/ppt/close` (`filePath`) for every deck you created or opened yourself:
|
|
140
|
+
|
|
141
|
+
- **Last**: after the final edit and after `/ppt/review-slides`. Close saves first, so nothing is lost.
|
|
142
|
+
- Skip it for a deck the user already had open before your first call: you attached to their window, and closing it would save and close it on them.
|
|
143
|
+
- Skip it when the user asked to see the deck or keep it open.
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## File Resolution — ALWAYS Required Before Open/Attach
|
|
148
|
+
|
|
149
|
+
**`/ppt/open-attach` requires a full absolute file path.** A bare filename will fail.
|
|
150
|
+
|
|
151
|
+
**`/ppt/open-attach` must be its own standalone call — NEVER batch it with other operations.** Batch operations run independently; the presentation attachment from one operation does not carry into the next operation in the same batch.
|
|
152
|
+
|
|
153
|
+
**Always pass `filePath` to every subsequent PPT API call.** All PowerPoint endpoints require `filePath` in the request body. Use the `filePath` returned in the `open-attach` response.
|
|
154
|
+
|
|
155
|
+
Whenever the user refers to a presentation **without giving you the full path** (any name, partial or full), call `file_discovery` first:
|
|
156
|
+
|
|
157
|
+
```json
|
|
158
|
+
{ "appType": "ppt", "partialName": "<name the user gave>" }
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
| Response | Action |
|
|
162
|
+
|----------|--------|
|
|
163
|
+
| `confidence: 'exact'` | Pass `resolved.filePath` to `/ppt/open-attach` |
|
|
164
|
+
| `confidence: 'ambiguous'` | Show the `matches` list and ask the user which file |
|
|
165
|
+
| NOT FOUND (plain text) | Ask the user for the full file path — STRICTLY FORBIDDEN to search the filesystem (no `find`, `ls`, `mdfind`, `execute_bash_command`, or any other command) |
|
|
166
|
+
|
|
167
|
+
### Opening Files from SharePoint / OneDrive / Browser URLs
|
|
168
|
+
|
|
169
|
+
When the user wants to open a presentation that is on **SharePoint**, **OneDrive**, or currently **open in the browser**:
|
|
170
|
+
|
|
171
|
+
**NEVER try to download via HTTP** — SharePoint URLs require authentication and return HTML instead of the file. **NEVER click browser UI** to find the file — it is fragile, slow, and lands on similarly-named wrong files.
|
|
172
|
+
|
|
173
|
+
1. **Try the original URL with `ms-powerpoint:` first — no conversion.** Desktop PowerPoint is signed into the user's Microsoft account and can resolve sharing-link tokens directly through Microsoft's sharing service. Works for every shape SharePoint emits, including:
|
|
174
|
+
- `:p:/g/personal/<user>_<domain>_<tld>/<opaque-id>?e=...` (older sharing token)
|
|
175
|
+
- `:p:/p/<user>/<opaque-id>?e=...` (newer personalized sharing token)
|
|
176
|
+
- `:p:/r/personal/<user>/_layouts/15/Doc.aspx?sourcedoc={GUID}&file=<name>.pptx&action=edit` (browser "Open in PowerPoint" link)
|
|
177
|
+
|
|
178
|
+
Most SharePoint URLs work without any rewriting:
|
|
179
|
+
- **Windows:** `ExecutePowershellCommand: Start-Process "POWERPNT.EXE" -ArgumentList "/o `"<original_url>`""`
|
|
180
|
+
- **macOS:** `osascript -e 'open location "ms-powerpoint:ofe|u|<original_url>"'` (the shell `open` command corrupts nested `https://` URLs — use AppleScript)
|
|
181
|
+
|
|
182
|
+
Wait a few seconds, then call `/ppt/get-opened-files` to confirm. If the right file opened, you are done.
|
|
183
|
+
|
|
184
|
+
2. **If step 1 fails AND the URL has a `/Documents/<file>.pptx` style path**, retry with the converted direct URL. Conversion rules:
|
|
185
|
+
- **Strip** `/:p:/r/`, `/:p:/g/`, or `/:p:/p/` routing prefixes
|
|
186
|
+
- **Strip** query parameters (`?sourcedoc=...&action=edit`, `?d=w...`, `?e=...`)
|
|
187
|
+
- **Strip** `_layouts/15/Doc.aspx` paths — if the URL only has this (no `.pptx` path), skip to step 3
|
|
188
|
+
- **Fix domain** for personal OneDrive: `company.sharepoint.com` → `company-my.sharepoint.com` (when path contains `/personal/`)
|
|
189
|
+
```
|
|
190
|
+
Browser: https://uipath.sharepoint.com/:p:/r/personal/user_uipath_com/Documents/Deck.pptx
|
|
191
|
+
Direct: https://uipath-my.sharepoint.com/personal/user_uipath_com/Documents/Deck.pptx
|
|
192
|
+
|
|
193
|
+
Browser: https://company.sharepoint.com/:p:/r/sites/team/Shared%20Documents/Report.pptx?d=w...
|
|
194
|
+
Direct: https://company.sharepoint.com/sites/team/Shared%20Documents/Report.pptx
|
|
195
|
+
```
|
|
196
|
+
This conversion does NOT work for sharing-link-token URLs (`/personal/<user>/<opaque-id>` with no file path) — those have only step 1.
|
|
197
|
+
|
|
198
|
+
3. **If both fail, ASK the user.** Either ask for a different URL (a direct document URL with a `.pptx` path), or ask whether the file is already open in PowerPoint so you can attach to it via `/ppt/get-opened-files`. **NEVER scan the browser windows for similarly-named files and pick one — you will land on the wrong file.**
|
|
199
|
+
|
|
200
|
+
4. After the file is open, use `/ppt/get-opened-files` to get the file path (which may be a SharePoint URL). **SharePoint URLs are valid file paths** for all `/ppt/*` endpoints — pass them as-is to `filePath`, `sourceFilePath`, etc.
|
|
201
|
+
|
|
202
|
+
5. **If the file is already open in the desktop app** (user opened it manually), just call `/ppt/get-opened-files` to get the file path and proceed.
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## Strategy & Outline (BEFORE Creating/Editing)
|
|
207
|
+
|
|
208
|
+
**Define the presentation story BEFORE touching PowerPoint.**
|
|
209
|
+
|
|
210
|
+
1. **Clarify Objective**: Who is the audience? What is the ONE main takeaway? What decisions should this enable?
|
|
211
|
+
2. **Plan Slide Titles**: Write clear, descriptive titles for each slide. Prefer concise titles that frame the content (e.g. "Market Opportunity", "Key Challenges", "Implementation Roadmap") over long sentences that repeat what the body already says. Read the titles in sequence to check they tell a logical story.
|
|
212
|
+
3. **One Message Per Slide**: Each slide should focus on one topic. If a slide covers too much, split it.
|
|
213
|
+
4. **Standard Structure**: Title → Executive Summary → Background → Key Findings → Recommendations → Closing.
|
|
214
|
+
5. **Template & Branding**: Always ask for business presentations: "Do you have a corporate template?" Priority: user-provided template > reference presentation > built-in themes.
|
|
215
|
+
|
|
216
|
+
### Theme Selection (MANDATORY — Read Before Generating)
|
|
217
|
+
|
|
218
|
+
**Choose the `subject`, set `theme: "auto"`.** Do NOT hard-code a `theme` for normal generation. The generator picks a theme from the subject's pool and rotates across runs (skipping recently used ones), so repeated prompts get varied, non-repeating themes. Hard-coding a theme makes every run of the same prompt identical.
|
|
219
|
+
|
|
220
|
+
Set an explicit `theme` ONLY when the user names one, or for a custom `themePath` (`.thmx`/classic theme).
|
|
221
|
+
|
|
222
|
+
Pick the `subject` that fits the content + audience:
|
|
223
|
+
|
|
224
|
+
| Content / Audience | `subject` | Pool the generator rotates (FYI, do not pick from this yourself) |
|
|
225
|
+
|---|---|---|
|
|
226
|
+
| Kids, fun, playful | `creative` | nature-inspired, warm-sunset, coral-reef, sand-stone, gradient-modern, electric-neon |
|
|
227
|
+
| Corporate, formal | `business` | corporate-elegant, steel-gray, dark-professional, minimal-clean, ocean-blue, sand-stone, midnight-executive, charcoal-ink |
|
|
228
|
+
| Tech, developer | `tech` | dark-professional, ocean-blue, arctic-frost, charcoal-ink, midnight-executive, steel-gray, gradient-modern |
|
|
229
|
+
| Science, nature, animals | `science` | arctic-frost, ocean-blue, minimal-clean, nature-inspired, steel-gray, forest-deep |
|
|
230
|
+
| Education, training | `education` | nature-inspired, warm-sunset, minimal-clean, ocean-blue, sand-stone, arctic-frost, coral-reef, steel-gray |
|
|
231
|
+
| Startup, pitch | `startup` | gradient-modern, bold-impact, electric-neon, coral-reef, ocean-blue, royal-purple, warm-sunset |
|
|
232
|
+
| Sustainability, green | `sustainability` | nature-inspired, forest-deep, sand-stone, minimal-clean, ocean-blue |
|
|
233
|
+
| Data, analytics | `data` | steel-gray, minimal-clean, arctic-frost, charcoal-ink, ocean-blue, corporate-elegant, dark-professional |
|
|
234
|
+
| Lifestyle, wellness | `lifestyle` | warm-sunset, nature-inspired, coral-reef, sand-stone, forest-deep, minimal-clean |
|
|
235
|
+
| Event, conference | `event` | bold-impact, electric-neon, coral-reef, warm-sunset, royal-purple, gradient-modern, ocean-blue |
|
|
236
|
+
| Keynote, motivational | `bold` | bold-impact, electric-neon, gradient-modern, midnight-executive, royal-purple, ocean-blue |
|
|
237
|
+
| Clean, neutral | `minimal` | minimal-clean, plain-neutral, steel-gray, arctic-frost, sand-stone, corporate-elegant |
|
|
238
|
+
|
|
239
|
+
**Rules:**
|
|
240
|
+
- Match the AUDIENCE, not just the topic ("dinosaurs for kids" → `creative`, not a dark subject).
|
|
241
|
+
- Pick the subject whose palette fits the topic: forests/plants → `sustainability` or `science` (greens); desert → `lifestyle` (warm sand); ocean/space/tech → `tech` or `science` (deep blues, dark).
|
|
242
|
+
- Variety across repeats is the generator's job now, not yours: pick the right `subject` and use `theme: "auto"`.
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
## API vs UIA Decision Guide
|
|
247
|
+
|
|
248
|
+
| Category | Use | Examples |
|
|
249
|
+
|----------|-----|---------|
|
|
250
|
+
| **API (90%)** | All standard operations | text (`/ppt/add-text-to-slide`), HTML content (`/ppt/add-html-to-slide`), text boxes (`/ppt/insert-text-box` on macOS; Windows uses `/ppt/add-text-to-slide` with a new `targetShapeName`), shapes (`/ppt/insert-shape`), formatting (`/ppt/format-slide-content`, `/ppt/format-shape`), slides (add/duplicate/delete/reorder), tables, images, transitions, animations, speaker notes, find/replace, health check, analyze, extract data |
|
|
251
|
+
| **UIA (10%)** | Fallback after 2 API failures | Ribbon interactions, custom color picker, complex dialogs, and visible-window screenshots. **Requires a visible window**, so it is not available in the default windowless flow |
|
|
252
|
+
| **Scripts** | No API exists | Remove bullet formatting, delete specific shapes, modify chart data, custom formatting |
|
|
253
|
+
|
|
254
|
+
**`/ppt/add-html-to-slide` vs `/ppt/add-text-to-slide`:**
|
|
255
|
+
|
|
256
|
+
Default to `/ppt/add-html-to-slide` for any non-trivial text edit. Native PowerPoint formatting in a single call. **Available on both macOS and Windows.**
|
|
257
|
+
|
|
258
|
+
| Scenario | Use |
|
|
259
|
+
|----------|-----|
|
|
260
|
+
| Plain text, single style (titles, simple body) | `/ppt/add-text-to-slide` |
|
|
261
|
+
| **Bold section headers + regular body** | **`/ppt/add-html-to-slide`** |
|
|
262
|
+
| **Bullet/numbered lists** | **`/ppt/add-html-to-slide`** |
|
|
263
|
+
| **Mixed bold + italic + regular** | **`/ppt/add-html-to-slide`** |
|
|
264
|
+
| **Content with multiple sections** | **`/ppt/add-html-to-slide`** |
|
|
265
|
+
| **Anything you'd otherwise format afterward** | **`/ppt/add-html-to-slide`** |
|
|
266
|
+
|
|
267
|
+
**Rule of thumb:** If you'd need add-text + format-slide-content to make it look right, use add-html instead. `**...**` markers in `add-text-to-slide` work on both platforms, but prefer HTML tags (`<b>`, `<i>`, `<ul>`, `<p>`) via `add-html-to-slide` for mixed formatting — one call instead of add-text + format-slide-content. Supported tags: `<b>/<strong>`, `<i>/<em>`, `<u>`, `<br>`, `<p>`, `<ul>`/`<ol>` + `<li>`, `<h1>`-`<h4>`. Heading sizes: h1=28pt, h2=24pt, h3=20pt, h4=18pt.
|
|
268
|
+
|
|
269
|
+
**Parameter naming gotcha:** `add-text-to-slide` and `add-html-to-slide` use `targetShapeName`. `format-slide-content` and `format-shape` use `shapeName`. Same shape value (from `analyze-slide-content`'s `name` field), different parameter name. Get this wrong and the API rejects the call with "required field missing".
|
|
270
|
+
|
|
271
|
+
**NEVER use scripts for:** extracting data (use `/ppt/extract-slide-data`), getting shape names (use `/ppt/analyze-slide-content`). Scripts are OK for modifying data that has no dedicated API (e.g., chart data manipulation).
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
## Task Planning for Complex Requests
|
|
276
|
+
|
|
277
|
+
### Execution Order: Follow the User's Prompt
|
|
278
|
+
|
|
279
|
+
Execute tasks in the order the user mentions them. Use CURRENT slide numbers at each step.
|
|
280
|
+
|
|
281
|
+
```
|
|
282
|
+
User says: "Change slide 1 title, add slide after 4, duplicate slide 7"
|
|
283
|
+
|
|
284
|
+
Execute as:
|
|
285
|
+
1. Change slide 1 title (slide 1 is current slide 1)
|
|
286
|
+
2. Add slide after 4 (now 8 slides exist)
|
|
287
|
+
3. Duplicate slide 7 (the CURRENT slide 7, not the original)
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
**Exception:** Only track original positions if user explicitly says "the original slide 7" or "the slide that was slide 7 before".
|
|
291
|
+
|
|
292
|
+
### One Task = One Operation
|
|
293
|
+
|
|
294
|
+
Split any task containing "and", "then", or commas:
|
|
295
|
+
|
|
296
|
+
| ❌ BAD | ✅ GOOD |
|
|
297
|
+
|--------|---------|
|
|
298
|
+
| "Duplicate slide 7 and rename to X" | "Duplicate slide 7"<br>"Change duplicated slide title to X" |
|
|
299
|
+
| "Insert bar chart and doughnut chart" | "Insert bar chart slide after slide 4"<br>"Insert doughnut chart slide at end" |
|
|
300
|
+
|
|
301
|
+
**Common trap:** "Duplicate and rename" is TWO operations - duplicate first, then change title.
|
|
302
|
+
|
|
303
|
+
### Required Phases (in order)
|
|
304
|
+
|
|
305
|
+
```
|
|
306
|
+
1. REFERENCE → If reference presentation exists: Open, use /ppt/analyze-slide-content + /ppt/extract-slide-data to understand layouts
|
|
307
|
+
2. CREATION → Generate presentation (if creating new)
|
|
308
|
+
3. OPEN → /ppt/open-attach (windowless - do NOT pass visible unless the user asked to see it)
|
|
309
|
+
4. SETUP → Analyze (before edits)
|
|
310
|
+
5. EDITS → Execute → Verify (review-slides, or ReadFile the .pptx for rendered slides) → Fix
|
|
311
|
+
6. CLEANUP → Delete empty placeholders (if requested)
|
|
312
|
+
7. HEALTH CHECK → ALWAYS run /ppt/review-slides to catch technical issues
|
|
313
|
+
8. FULL REVIEW → Core Principle 4: offer it, or run it now if the user already asked
|
|
314
|
+
9. COMPLETION → Inform user of completion
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
### Duplicated Slide Content (CRITICAL)
|
|
318
|
+
|
|
319
|
+
**When you duplicate a slide, ALL content is already copied!**
|
|
320
|
+
|
|
321
|
+
After duplicating:
|
|
322
|
+
- Title, subtitle, body content, images/charts → **already there** from original slide
|
|
323
|
+
|
|
324
|
+
**DO NOT re-add content that already exists!** Only modify what needs to CHANGE.
|
|
325
|
+
|
|
326
|
+
| Scenario | ❌ WRONG | ✅ CORRECT |
|
|
327
|
+
|----------|----------|------------|
|
|
328
|
+
| Duplicate slide 3, change title | Add title "New Title" | Use `clearExistingText: true` to REPLACE title |
|
|
329
|
+
| Duplicate template, keep subtitle | Add subtitle text again | **Do nothing** - subtitle is already there |
|
|
330
|
+
| Duplicate slide, update one bullet | Add all bullets again | Use `/ppt/replace-text` to change specific text |
|
|
331
|
+
|
|
332
|
+
**Rule:** After duplicating, only call PptAddText with `clearExistingText: true` for content that needs to CHANGE. Leave unchanged content alone.
|
|
333
|
+
|
|
334
|
+
### Re-Analyze When Needed
|
|
335
|
+
|
|
336
|
+
Call `/ppt/analyze-slide-content` before editing to discover shape names. Not required between every step — only when you need current structure info (e.g., after inserting/duplicating slides, or editing a slide for the first time).
|
|
337
|
+
|
|
338
|
+
---
|
|
339
|
+
|
|
340
|
+
## Workflow Decision
|
|
341
|
+
|
|
342
|
+
| User Intent | Workflow | Method |
|
|
343
|
+
|-------------|----------|--------|
|
|
344
|
+
| "Create a presentation about..." | **Creation** | PowerPoint Generator |
|
|
345
|
+
| "Make me a deck for..." | **Creation** | PowerPoint Generator |
|
|
346
|
+
| "Using this .thmx/.pptx theme file, create..." | **Creation** | PowerPoint Generator with `themePath` — ALWAYS use the generator, it handles theme files |
|
|
347
|
+
| "Use this presentation's style/theme to create..." | **Creation** | Analyze reference with `/ppt/analyze-slide-content`, then Generator with `themePath` pointing to the reference `.pptx` |
|
|
348
|
+
| "Move/migrate my presentation to this new template" | **mixed** | See **Recreate/Convert Workflow** below |
|
|
349
|
+
| "Recreate this deck in the new design/theme" | **mixed** | See **Recreate/Convert Workflow** below |
|
|
350
|
+
| "Reuse these exact slides with different content" | **Editing** | Duplicate template slides + replace content (preserves exact slide designs) |
|
|
351
|
+
| "Edit my presentation" | **Editing** | ExecuteSkillApi (/ppt/*) |
|
|
352
|
+
| "Add a slide to..." | **Editing** | ExecuteSkillApi (/ppt/*) |
|
|
353
|
+
| "Change the text on slide 3" | **Editing** | ExecuteSkillApi (/ppt/*) |
|
|
354
|
+
| "Extract content from this PPTX" | **Editing** | ExecuteSkillApi (/ppt/*) |
|
|
355
|
+
|
|
356
|
+
**⚠️ CRITICAL: "Using this template" — Two Different Scenarios:**
|
|
357
|
+
|
|
358
|
+
| Scenario | What happens | Correct approach |
|
|
359
|
+
|----------|-------------|-----------------|
|
|
360
|
+
| User provides a `.thmx` or `.pptx` file as theme source | Theme file with colors, fonts, backgrounds, slide layouts | **Use Generator** with `themePath`. |
|
|
361
|
+
| User has a reference presentation → `/ppt/get-presentation-info` returns a **real theme** (not "Office Theme" / blank) | Presentation has a proper custom theme with slide layouts | **Use Generator** with `themePath` pointing to the reference `.pptx`. |
|
|
362
|
+
| User has a reference presentation → `/ppt/get-presentation-info` returns "Office Theme" or a generic theme, but slides are visually styled | Styling is baked into individual slides, not in a reusable theme | **Duplicate workflow:** copy slides from reference, replace content with `clearExistingText: true`. The theme can't be extracted, so you must preserve the slides themselves. |
|
|
363
|
+
| User explicitly wants to **reuse exact slide designs** | Copy specific slides as-is | **Duplicate workflow.** |
|
|
364
|
+
|
|
365
|
+
**Decision flow:** Check `/ppt/get-presentation-info` → if `themeName` is a real custom theme → Generator with `themePath`. If `themeName` is generic/blank but slides look styled → duplicate + replace content.
|
|
366
|
+
|
|
367
|
+
**🚨 FORBIDDEN PATTERN — NEVER DO THIS:**
|
|
368
|
+
```
|
|
369
|
+
❌ Generator creates empty/minimal presentation with a built-in theme → open it → add slides one by one via /ppt/insert-slide → add text via /ppt/add-text-to-slide
|
|
370
|
+
```
|
|
371
|
+
**This is the WORST approach.** Use the Generator with `themePath` instead — it handles theme application and slide creation in one call.
|
|
372
|
+
|
|
373
|
+
---
|
|
374
|
+
|
|
375
|
+
## Recreate/Convert Workflow (CRITICAL)
|
|
376
|
+
|
|
377
|
+
When recreating/converting/migrating a presentation to a new theme, first analyze the source with `/ppt/extract-slide-data` on ALL slides to assess complexity:
|
|
378
|
+
|
|
379
|
+
| Source deck complexity | How to detect | Approach |
|
|
380
|
+
|----------------------|---------------|----------|
|
|
381
|
+
| **Simple** (mostly text, 0-1 tables, no images) | Only text shapes, maybe one table | **Generator** with `themePath` — use diverse layouts (`content`, `stats`, `comparison`, `timeline`). NEVER put all slides into `content`. |
|
|
382
|
+
| **Complex** (multiple tables, charts, images, many shapes) | `extract-slide-data` returns `tables`/`charts` arrays on several slides, or slides have 10+ shapes | **Copy + apply theme:** see steps below. |
|
|
383
|
+
|
|
384
|
+
**Complex deck workflow (file copy + apply theme):**
|
|
385
|
+
1. **Copy the source file** to a new path using PowerShell/bash (e.g., `Copy-Item "source.pptx" "new.pptx"`)
|
|
386
|
+
2. **Open** the copy via `/ppt/open-attach` (NOT `createNew`)
|
|
387
|
+
3. **Apply the new theme** via `/ppt/apply-theme` with `themeFilePath` pointing to the new `.thmx`/`.pptx`
|
|
388
|
+
4. Review with `/ppt/review-slides` and fix any remaining styling issues
|
|
389
|
+
|
|
390
|
+
**⚠️ Do NOT use `/ppt/copy-slides` to copy into a new blank presentation** — `InsertFromFile` embeds source formatting too deeply for `apply-theme` to override, causing invisible text. Instead, copy the file itself and retheme it.
|
|
391
|
+
|
|
392
|
+
This approach preserves all content structure (tables, charts, images) AND properly applies the new theme colors. Choose ONE approach for the whole deck, not per-slide.
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## Visual Verification (CRITICAL)
|
|
397
|
+
|
|
398
|
+
**Visual Verification is NOT optional.** Use API endpoints (`/ppt/analyze-slide-content`, `/ppt/extract-slide-data`, `/ppt/review-slides`) for structural analysis. For appearance (alignment, readability, professional look), **`ReadFile` the `.pptx`**: it returns one rendered image per slide, sliced across reads for long decks. Do NOT screenshot, the deck is windowless and there is nothing on screen.
|
|
399
|
+
|
|
400
|
+
```
|
|
401
|
+
1. Make change (API call)
|
|
402
|
+
2. Verify via /ppt/review-slides or /ppt/analyze-slide-content
|
|
403
|
+
3. /ppt/save-presentation ← MANDATORY before any ReadFile of the .pptx
|
|
404
|
+
4. ReadFile the .pptx if a visual check is needed (layout, alignment, colors)
|
|
405
|
+
5. Fix issues in one pass → proceed (Core Principle 4)
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
**🚨 Always `/ppt/save-presentation` before you `ReadFile` a deck you have been editing.** A deck built through the API holds slides that are not yet on disk, so a reader gets a stale or empty file. The symptom is a review that comes back with `Presentation has no slides to export` and then attaches the raw `.pptx` instead of slide images, which wastes the whole turn. `/ppt/close` also saves, but only use it when you are finished with the deck.
|
|
409
|
+
|
|
410
|
+
The rendered images are pixel-identical to what the user gets on opening the file, so what you review is exactly what they will see.
|
|
411
|
+
|
|
412
|
+
When user provides a reference presentation: use `/ppt/analyze-slide-content` and `/ppt/extract-slide-data` to understand layouts/fonts/spacing, match them EXACTLY. When the user wants a content review, `Agent` with `agent_type: "review"` is the final quality gate.
|
|
413
|
+
|
|
414
|
+
---
|
|
415
|
+
|
|
416
|
+
## Visual Styling Rules (MANDATORY)
|
|
417
|
+
|
|
418
|
+
📄 **YOU MUST READ `<skill-path>/visual-styling-guide.md` NOW** before creating or editing — contains color palettes, font pairings, space utilization rules, formatting examples, and the pre-submission checklist. Skipping this file leads to bland, inconsistent presentations.
|
|
419
|
+
|
|
420
|
+
**These rules are MANDATORY for ALL presentations. Violations will be flagged by health check.**
|
|
421
|
+
|
|
422
|
+
### Font Sizes
|
|
423
|
+
|
|
424
|
+
| Element | Size | Notes |
|
|
425
|
+
|---------|------|-------|
|
|
426
|
+
| Titles | 36-44pt bold | Must be larger than body |
|
|
427
|
+
| Subtitles | 24-32pt bold | |
|
|
428
|
+
| Body (normal) | 18-24pt | |
|
|
429
|
+
| Body (dense/quotes) | 14-16pt | |
|
|
430
|
+
| Minimum | 12pt | Never below this |
|
|
431
|
+
| 2-column body | 18-20pt (min 14pt) | |
|
|
432
|
+
|
|
433
|
+
**Use 2-3 fonts max.** Aim for 20-30% empty space per slide.
|
|
434
|
+
|
|
435
|
+
### Text Rules
|
|
436
|
+
|
|
437
|
+
- **Hierarchy**: Title (bold, largest) → Subtitle (bold, medium) → Body (regular, base)
|
|
438
|
+
- **NEVER repeat titles in body content** — the title shape already has it. ❌ `Title="Product Focus", Body="Product Focus:\n- bullet 1"` → ✅ `Body="- bullet 1\n- bullet 2"`
|
|
439
|
+
- **Section headers MUST be bold** — use `/ppt/add-html-to-slide` for new content with mixed formatting, or `/ppt/format-slide-content` to bold existing text via `textMatch`
|
|
440
|
+
- **NEVER use underline** — underline is a web convention (hyperlinks), not for presentations. Use **bold** for emphasis, *italic* sparingly for quotes. Health check flags underline — fix immediately.
|
|
441
|
+
- **NEVER use all caps** for body text — only acceptable for short titles/headers
|
|
442
|
+
- **NEVER use more than 2 emphasis styles** on the same text (e.g., bold + italic + color)
|
|
443
|
+
- **Bullet cleanup**: Remove leading "- "/"• " if shape has auto-bullets. Verify indentation is consistent.
|
|
444
|
+
- **Empty lines**: Remove empty lines between plain bullet points in simple content slides. But **NEVER remove empty lines on timeline slides, feature blocks, or custom-themed slides** — those empty lines are INTENTIONAL section separators (between timeline entries, between feature groups, between content sections). **If the slide is a timeline, has grouped content, or uses a custom theme → SKIP the empty lines fix entirely. Do not touch them.**
|
|
445
|
+
|
|
446
|
+
### Content Density (The 3-Second Rule)
|
|
447
|
+
|
|
448
|
+
The audience should grasp each slide's point in 3 seconds. If a slide has 40+ words, it takes 15+ seconds to read.
|
|
449
|
+
|
|
450
|
+
| Slide Type | Max Items | Max Words |
|
|
451
|
+
|------------|-----------|-----------|
|
|
452
|
+
| Bullet list | 4-5 points | 30 |
|
|
453
|
+
| With image | 3 short phrases | 18 |
|
|
454
|
+
| Stats/numbers | 3-4 metrics | N/A (labels) |
|
|
455
|
+
| Comparison | 3-4 per side | 25 |
|
|
456
|
+
| Table rows | 5-6 visible rows | N/A |
|
|
457
|
+
| Line chart | 4-5 data series | N/A |
|
|
458
|
+
|
|
459
|
+
**Slide count:** 7-10 default. "Brief" → 5-7. "Detailed" → 12-15. User specifies exact count → use that count. Split if content exceeds limits.
|
|
460
|
+
|
|
461
|
+
### Layout Consistency
|
|
462
|
+
|
|
463
|
+
- **Same layout** for similar slides (all "Feedback" slides match, all "Feature" slides match)
|
|
464
|
+
- **Same font sizes** across similar slides — if existing slides use a specific font size, match it exactly on new slides
|
|
465
|
+
- **Insert new slides** rather than modifying template placeholder slides (avoids unwanted inherited formatting)
|
|
466
|
+
- **Reference existing slides** — if slide 5 is "Feedback Part 1", slide 6 should match its layout exactly
|
|
467
|
+
- Center titles, left-align body. Equal vertical spacing. Min 0.5" margins.
|
|
468
|
+
- **Contrast**: 4.5:1 minimum (WCAG). Dark text on light OR light text on dark.
|
|
469
|
+
|
|
470
|
+
### Charts & Tables
|
|
471
|
+
|
|
472
|
+
- Center horizontally, position below title, fill 70-80% of available space
|
|
473
|
+
- Legend text min 12pt. Use contrasting colors for data series.
|
|
474
|
+
- Bar charts: Y-axis starts at zero. Line charts: max 4-5 series.
|
|
475
|
+
|
|
476
|
+
---
|
|
477
|
+
|
|
478
|
+
## Important: Resolving `<skill-path>`
|
|
479
|
+
|
|
480
|
+
Throughout this documentation, `<skill-path>` refers to **this skill's folder**:
|
|
481
|
+
- This skill's location is the path to this SKILL.md file
|
|
482
|
+
- Remove the filename (SKILL.md) to get the skill folder
|
|
483
|
+
- Example: If location is `/path/to/powerpoint-architect/SKILL.md`, then `<skill-path>` = `/path/to/powerpoint-architect`
|
|
484
|
+
|
|
485
|
+
---
|
|
486
|
+
|
|
487
|
+
## Part 1: Creating New Presentations (Generator)
|
|
488
|
+
|
|
489
|
+
Use the **PowerPoint Generator** when creating presentations from scratch. No PowerPoint installation required.
|
|
490
|
+
|
|
491
|
+
**🚨 The Generator creates the COMPLETE presentation — ALL slides with ALL content — in ONE call.** Put every slide in the `slides` array. NEVER create an empty/minimal presentation and then add slides via API. NEVER open the generated file and then use `/ppt/insert-slide` to add more slides. The Generator is a single-shot operation: one call = finished presentation.
|
|
492
|
+
|
|
493
|
+
### Quick Start
|
|
494
|
+
|
|
495
|
+
Use ExecuteSkillApi to generate presentations:
|
|
496
|
+
|
|
497
|
+
```
|
|
498
|
+
ExecuteSkillApi:
|
|
499
|
+
endpoint: "/ppt-gen/generate"
|
|
500
|
+
body: {
|
|
501
|
+
"options": {
|
|
502
|
+
"title": "My Presentation",
|
|
503
|
+
"theme": "dark-professional",
|
|
504
|
+
"outputPath": "C:\\Users\\me\\Documents\\presentation.pptx"
|
|
505
|
+
},
|
|
506
|
+
"slides": [
|
|
507
|
+
{ "layout": "title", "title": "Welcome", "subtitle": "Introduction" },
|
|
508
|
+
{ "layout": "content", "title": "Key Points", "body": ["Point 1", "Point 2"] },
|
|
509
|
+
{ "layout": "closing", "title": "Thank You" }
|
|
510
|
+
]
|
|
511
|
+
}
|
|
512
|
+
toolName: "Generate Presentation"
|
|
513
|
+
description: "Generating a new presentation from scratch"
|
|
514
|
+
```
|
|
515
|
+
|
|
516
|
+
**🚨 AFTER GENERATION:** `/ppt/open-attach` windowless (no `visible`), then follow Core Principle 4: run `/ppt/review-slides`, plus the content review if the user asked for one, and fix both in the one corrective pass. Tell the user where the file is. Do not show the deck unless the user asked to see it.
|
|
517
|
+
|
|
518
|
+
|
|
519
|
+
### Generator JSON Format & Theme Options
|
|
520
|
+
|
|
521
|
+
📄 **YOU MUST READ `<skill-path>/generator-reference.md` NOW** before building the JSON — contains the complete format for stats, charts, tables, icons, comparison layout, and theme options. Without this, your JSON will be malformed.
|
|
522
|
+
|
|
523
|
+
**JSON skeleton:**
|
|
524
|
+
```json
|
|
525
|
+
{
|
|
526
|
+
"options": {
|
|
527
|
+
"title": "Presentation Title",
|
|
528
|
+
"theme": "dark-professional",
|
|
529
|
+
"outputPath": "/path/to/output.pptx",
|
|
530
|
+
"author": "Name",
|
|
531
|
+
"subject": "tech"
|
|
532
|
+
},
|
|
533
|
+
"slides": [
|
|
534
|
+
{ "layout": "title", "title": "Welcome", "subtitle": "Subtitle" },
|
|
535
|
+
{ "layout": "content", "title": "Key Points", "body": ["Point 1", "Point 2"] }
|
|
536
|
+
]
|
|
537
|
+
}
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
**Theme options (pick ONE):**
|
|
541
|
+
|
|
542
|
+
| Option | When to use | Example |
|
|
543
|
+
|--------|-------------|---------|
|
|
544
|
+
| `theme` | Built-in or classic PowerPoint themes | `"theme": "corporate-elegant"` |
|
|
545
|
+
| `themePath` | Custom `.thmx` or `.pptx` file | `"themePath": "/path/to/theme.thmx"` |
|
|
546
|
+
|
|
547
|
+
**🚨 Never use both `theme` and `themePath` together.**
|
|
548
|
+
|
|
549
|
+
**When using `themePath`:** the generator drives PowerPoint **windowless** (nothing appears on screen): it creates a blank presentation, applies the full theme from the source `.thmx`/`.pptx` (backgrounds, layouts, colors, fonts), then adds slides one at a time using the theme's own slide layouts. This requires Microsoft Office to be installed.
|
|
550
|
+
|
|
551
|
+
Adding slides one at a time is inherent to `themeMode: "full"` — a template's masters, layouts and backgrounds cannot be reproduced by the pure-JS generator, so each slide has to be built against the real theme. Expect roughly a second per slide, versus a single call for a built-in theme. That is normal, not a fault.
|
|
552
|
+
|
|
553
|
+
| `themeMode` | Fidelity | Cost |
|
|
554
|
+
|---|---|---|
|
|
555
|
+
| `"full"` (default) | Complete: layouts, masters, backgrounds, colors, fonts | Needs Office, ~1s per slide, windowless |
|
|
556
|
+
| `"extract"` | Colors and fonts only, no layouts or backgrounds | No Office, single call |
|
|
557
|
+
|
|
558
|
+
**Built-in themes (18):** dark-professional, ocean-blue, midnight-executive, steel-gray, corporate-elegant, minimal-clean, gradient-modern, nature-inspired, bold-impact, plain-neutral, warm-sunset, arctic-frost, forest-deep, royal-purple, coral-reef, charcoal-ink, sand-stone, electric-neon.
|
|
559
|
+
|
|
560
|
+
**Classic PowerPoint themes** (require Office): ion, facet, gallery, integral, slice, retrospect, organic, badge, parallax, quotable, savon, wisp, banded, dividend, frame, metropolitan, berlin, celestial, circuit, damask, depth, droplet, madison, main-event, mesh, parcel, view, vapor-trail, wood-type, ion-boardroom, feathered, basis.
|
|
561
|
+
|
|
562
|
+
---
|
|
563
|
+
|
|
564
|
+
### Available Layouts
|
|
565
|
+
|
|
566
|
+
| Layout | Description |
|
|
567
|
+
|--------|-------------|
|
|
568
|
+
| `title` | Opening slide with title and subtitle |
|
|
569
|
+
| `section` | Section divider |
|
|
570
|
+
| `content` | Title + bullet points |
|
|
571
|
+
| `twoColumn` | Side-by-side content |
|
|
572
|
+
| `imageLeft` | Image on left, content on right |
|
|
573
|
+
| `imageRight` | Content on left, image on right |
|
|
574
|
+
| `imageFull` | Full-bleed image with overlay |
|
|
575
|
+
| `chart` | Data visualization (bar, line, pie, etc.) |
|
|
576
|
+
| `comparison` | Before/after or A vs B |
|
|
577
|
+
| `quote` | Testimonial or quote |
|
|
578
|
+
| `stats` | Key metrics/numbers |
|
|
579
|
+
| `timeline` | Process or timeline |
|
|
580
|
+
| `team` | Team member showcase |
|
|
581
|
+
| `features` | Feature cards — 2×2 grid (long descriptions) or row of 3-4 vertical cards (short descriptions) |
|
|
582
|
+
| `table` | Data table |
|
|
583
|
+
| `diagram` | Visual diagram rendered as image (architecture, flowchart, sequence, etc.) |
|
|
584
|
+
| `closing` | Thank you/contact slide |
|
|
585
|
+
| `blank` | Empty slide |
|
|
586
|
+
|
|
587
|
+
### 🎯 Layout Selection by Keywords (MANDATORY)
|
|
588
|
+
|
|
589
|
+
**Scan slide content for keywords → select matching layout. DO NOT default to `content`!**
|
|
590
|
+
|
|
591
|
+
| Keywords | Layout |
|
|
592
|
+
|----------|--------|
|
|
593
|
+
| "vs", "versus", "compared to", "pros/cons", "before/after", "A vs B", "option A/B", "Type X vs Type Y", comparing two categories/groups | `comparison` |
|
|
594
|
+
| Numbers, %, "$", "growth", "revenue", metrics | `stats` |
|
|
595
|
+
| "step", "phase", "timeline", "process", dates | `timeline` |
|
|
596
|
+
| "quote", "said", "testimonial" | `quote` |
|
|
597
|
+
| "team", names + roles/titles | `team` |
|
|
598
|
+
| Data rows/columns, tabular data | `table` |
|
|
599
|
+
| Trends, chart data, time series | `chart` |
|
|
600
|
+
| Product images, screenshots, visuals | `imageLeft`/`imageRight` |
|
|
601
|
+
| Hero image, full-screen visual | `imageFull` |
|
|
602
|
+
| Two UNRELATED parallel topics (not comparing!) | `twoColumn` |
|
|
603
|
+
| "features", "benefits", "advantages", "capabilities", "services", "pillars", "offerings", 3-4 distinct items each with title + description | `features` |
|
|
604
|
+
| "diagram", "architecture", "flowchart", "flow", "sequence", "state machine", "ER diagram", visual structure | `diagram` |
|
|
605
|
+
| Standard bullets (no keywords above) | `content` |
|
|
606
|
+
| Section break | `section` |
|
|
607
|
+
| First slide | `title` |
|
|
608
|
+
| "thank you", "questions", ending | `closing` |
|
|
609
|
+
|
|
610
|
+
**⚠️ `comparison` vs `twoColumn` vs `features`:**
|
|
611
|
+
- **`comparison`** = A vs B, pros/cons, before/after, two categories BEING COMPARED (e.g., "Garden Flowers vs Exotic Flowers", "Manual vs Automated")
|
|
612
|
+
- **`twoColumn`** = ONLY for truly unrelated side-by-side content NOT being compared
|
|
613
|
+
- **`features`** = 3-4 distinct items each with own title + description (visual card layout)
|
|
614
|
+
|
|
615
|
+
### Required Fields by Layout Type
|
|
616
|
+
|
|
617
|
+
**Every slide MUST have the appropriate content fields. Empty slides look unprofessional!**
|
|
618
|
+
|
|
619
|
+
| Layout | Required Fields | Notes |
|
|
620
|
+
|--------|-----------------|-------|
|
|
621
|
+
| `title` | `title`, `subtitle` | Opening slide |
|
|
622
|
+
| `section` | `title`, `subtitle` | Section number in subtitle (e.g., "01") |
|
|
623
|
+
| `content` | `title`, **`body`** | **MUST have body with bullet points!** |
|
|
624
|
+
| `twoColumn` | `title`, `columns[]` | Each column needs title and body (body as array of **3-6 short points**) |
|
|
625
|
+
| `imageLeft/Right` | `title`, **`body`**, `image` | **MUST have body AND image!** |
|
|
626
|
+
| `imageFull` | `title`, `image` | Full-bleed image required |
|
|
627
|
+
| `chart` | `title`, `chart` | Chart data required (see generator-reference.md) |
|
|
628
|
+
| `comparison` | `title`, `comparison` | Left/right with **3-6 short points each** (see generator-reference.md) |
|
|
629
|
+
| `quote` | `quote` | Quote text and author |
|
|
630
|
+
| `stats` | `title`, `stats[]` | At least 2-4 stats (see generator-reference.md) |
|
|
631
|
+
| `timeline` | `title`, `timeline` | Timeline items required. `timeline` accepts a bare array of items OR `{ items: [...], orientation }` |
|
|
632
|
+
| `team` | `title`, `team[]` | Each member: `name` (required), `role`/`bio`/`image` (optional) |
|
|
633
|
+
| `table` | `title`, `table` | `table.rows[][]` required; `table.headers[]`/`columnWidths[]` optional |
|
|
634
|
+
| `diagram` | `diagram` | `diagram.code` (Mermaid definition) required; `diagram.caption` optional. Or pass Mermaid code as a bare string |
|
|
635
|
+
| `features` | `title`, `columns[]` | 2-4 items, each with title, body, and optional icon |
|
|
636
|
+
| `blank` | none | Empty canvas — use for fully custom content or a single full-bleed `image` |
|
|
637
|
+
| `closing` | `title`, `subtitle` | Thank you message |
|
|
638
|
+
|
|
639
|
+
### Stats, Charts, Tables & Icons Format
|
|
640
|
+
📄 **YOU MUST READ `<skill-path>/generator-reference.md`** for detailed format specifications.
|
|
641
|
+
|
|
642
|
+
**Quick reference:**
|
|
643
|
+
- **Stats:** `value` (required), `label` (required); `prefix`/`suffix`/`change` (optional). `suffix: "%"` renders as circle visualization
|
|
644
|
+
- **Charts:** `type` (bar/line/pie/doughnut/area/scatter), `data[]` with `name`/`labels`/`values`. Also supports `categories`+`series` format. `showLegend`/`showValues`/`showGrid` (optional booleans)
|
|
645
|
+
- **Tables:** `headers[]` (optional), `rows[][]` (required), `columnWidths[]` (optional)
|
|
646
|
+
- **Images:** `path` (local file) OR `url` OR `base64`; `sizing` (`contain`/`cover`/`stretch`), `position`, `alt`, `caption` (all optional)
|
|
647
|
+
- **Comparison:** `left`/`right`, each `{ title, points[], highlight? }`; `vsLabel` (optional, default `"VS"`)
|
|
648
|
+
- **Icons:** react-icons names (e.g., `FaRocket`, `FaShieldAlt`). Work in `content`, `stats`, `timeline`, `twoColumn`, `features` layouts. **Prefer including icons** on these layouts when a suitable icon exists — they significantly improve visual quality. Use same icon set for consistency.
|
|
649
|
+
- **Per-slide speaker notes:** any slide can set `speakerNotes` (string) alongside its layout fields.
|
|
650
|
+
- **Top-level `options`:** `aspectRatio` (`'16:9'`/`'4:3'`/`'16:10'`, default `16:9`), `templatePath` (base .pptx to build on, requires PowerPoint), `company` (shown in slide metadata).
|
|
651
|
+
|
|
652
|
+
---
|
|
653
|
+
|
|
654
|
+
## 🖼️ Images in Presentations
|
|
655
|
+
|
|
656
|
+
📄 **YOU MUST READ `<skill-path>/images-guide.md` NOW** when the presentation includes `imageLeft`/`imageRight`/`imageFull` layouts or when the user requests images. Contains required image workflow — generate vs search, orientation rules, and how to include images in the JSON.
|
|
657
|
+
|
|
658
|
+
**Quick rules (MANDATORY):**
|
|
659
|
+
- **ALWAYS** add images: 2 for 5-7 slides, 3 for 8-10, 4 for 11+
|
|
660
|
+
- **MATCH orientation to placeholder**: `imageLeft`/`imageRight` → portrait images; `imageFull` → landscape images. When editing, check placeholder dimensions first with `/ppt/analyze-slide-content`. NEVER put a landscape image in a portrait space or vice versa.
|
|
661
|
+
- **Generate** (AI) for conceptual/abstract; **Search** (web) for real landmarks/people/places
|
|
662
|
+
- When generating, ALWAYS include orientation in the prompt (e.g., "portrait orientation, vertical composition")
|
|
663
|
+
- When searching, check image dimensions before downloading — skip images with wrong orientation
|
|
664
|
+
- Get images BEFORE building the JSON — include local file paths in `image.path`
|
|
665
|
+
- Alternate `imageLeft` ↔ `imageRight` for variety
|
|
666
|
+
|
|
667
|
+
---
|
|
668
|
+
|
|
669
|
+
## Part 2: Editing Existing Presentations
|
|
670
|
+
|
|
671
|
+
📄 **YOU MUST READ `<skill-path>/editing-guide.md` NOW** before any editing operation — contains content replacement rules (prevent doubling), create-to-edit workflow, health check response format, and troubleshooting. Skipping this causes silent content duplication and missed issues.
|
|
672
|
+
|
|
673
|
+
### Editing Essentials (always in context)
|
|
674
|
+
|
|
675
|
+
**Workflow:** Open → Analyze → Edit → Health Check → offer Agent review
|
|
676
|
+
```
|
|
677
|
+
1. /ppt/open-attach → windowless (no visible flag)
|
|
678
|
+
2. (skip /ppt/select-slide → it needs a window and changes nothing you can see)
|
|
679
|
+
3. /ppt/analyze-slide-content → get exact shape names (case-sensitive!)
|
|
680
|
+
4. /ppt/add-text-to-slide → use clearExistingText: true when replacing
|
|
681
|
+
5. /ppt/review-slides → automatic health check, fix issues
|
|
682
|
+
6. Content review → Core Principle 4 (offer it, or run it if already requested)
|
|
683
|
+
```
|
|
684
|
+
|
|
685
|
+
**Fallback strategy:** ExecuteSkillApi → C# Script (Windows only — macOS has no `/ppt/execute-script`) → UIA (AppAct). If the user forbids arbitrary Office scripts, never call `/ppt/execute-script`; stay with structured endpoints or report the limitation. Switch to UIA after 2 consecutive failures of the same operation. Reset for each new operation. **Hard stop: if any single approach fails 3 times, abandon it entirely and try a fundamentally different strategy (e.g., different layout, Generator instead of API, image instead of shapes). Never loop on a failing approach.**
|
|
686
|
+
|
|
687
|
+
### Theme Detection & Insert vs Duplicate (CRITICAL)
|
|
688
|
+
|
|
689
|
+
Call `/ppt/get-presentation-info` first. Check for `themeWarning`:
|
|
690
|
+
|
|
691
|
+
| `themeWarning` | Strategy |
|
|
692
|
+
|---|---|
|
|
693
|
+
| **absent** | `/ppt/insert-slide` is safe — new slides inherit theme styling |
|
|
694
|
+
| **present** | **MUST duplicate** existing slide + replace content (insert-slide would create plain white/black slide) |
|
|
695
|
+
|
|
696
|
+
Many presentations have visual styling applied manually but the underlying theme is still "Office Theme". Inserting a new slide inherits from the **theme**, not from the visual styling → breaks consistency.
|
|
697
|
+
|
|
698
|
+
**Duplicate workflow when themeWarning present:**
|
|
699
|
+
1. Find the existing slide whose layout best matches what you need
|
|
700
|
+
2. `/ppt/duplicate-slides` with `startSlideNumber` of that slide (+ `targetPosition` for placement)
|
|
701
|
+
3. Replace content with `/ppt/add-text-to-slide` using `clearExistingText: true`
|
|
702
|
+
4. **Format sub-headers and key terms** with `/ppt/format-slide-content` + `textMatch` (see "Text Formatting for Visual Hierarchy" below)
|
|
703
|
+
|
|
704
|
+
**Insert workflow when no themeWarning:**
|
|
705
|
+
1. `/ppt/insert-slide` with desired layout and position
|
|
706
|
+
2. Add content with `/ppt/add-text-to-slide`
|
|
707
|
+
3. **Format sub-headers and key terms** with `/ppt/format-slide-content` + `textMatch` (see "Text Formatting for Visual Hierarchy" below)
|
|
708
|
+
|
|
709
|
+
### Content Density Per Slide
|
|
710
|
+
|
|
711
|
+
| Element | Maximum |
|
|
712
|
+
|---------|---------|
|
|
713
|
+
| Bullet points | 5-7 |
|
|
714
|
+
| Words per slide (body text) | 30 (18 with images) |
|
|
715
|
+
| Sub-bullets per bullet | 2 |
|
|
716
|
+
|
|
717
|
+
**These are hard limits, not suggestions.** If your content exceeds them, you MUST split across multiple slides BEFORE calling add-text-to-slide. Slides are cheap, readability is not. Text overflowing beyond slide boundaries is a critical error.
|
|
718
|
+
|
|
719
|
+
**How to split:** If you have 4+ sections (e.g., Overview, Key Features, Performance, Use Cases), create one slide per 2 sections. A "Key Features" section alone with 4+ bullet points deserves its own slide.
|
|
720
|
+
|
|
721
|
+
### Key Rules
|
|
722
|
+
|
|
723
|
+
| Rule | Detail |
|
|
724
|
+
|------|--------|
|
|
725
|
+
| **ANALYZE before adding content** | NEVER call /ppt/add-text-to-slide on a new/duplicated slide without FIRST running /ppt/analyze-slide-content on a nearby EXISTING slide to capture fonts, sizes, colors. This is the #1 cause of mismatched slides. |
|
|
726
|
+
| **Use HTML for mixed-format content** | When a slide needs **bold sub-headers + body**, **bullet/numbered lists**, or any **mixed formatting** (bold + italic + regular), use `/ppt/add-html-to-slide` with `<p><b>Header</b><br>Body</p>` or `<ul><li>...</li></ul>` markup. Single call, native PowerPoint formatting, no post-processing. This is the **default for any non-trivial text edit**. Plain text → `/ppt/add-text-to-slide`. For formatting already-inserted text, use `/ppt/format-slide-content` with `textMatch`. `**...**` markers in `add-text-to-slide` work on both platforms too, but add-html-to-slide is the single-call option for mixed formatting. |
|
|
727
|
+
| **Max 4-5 bullets, 30 words per slide** | If content exceeds this, split across multiple slides. Text overflowing the slide boundary is a critical error. With images: max 3 phrases, 18 words. |
|
|
728
|
+
| **Shape names are case-sensitive** | "Title 1" ≠ "title 1" — copy exactly from analyze response |
|
|
729
|
+
| **clearExistingText: true** | Windows: ALWAYS when replacing content, prevents doubling. macOS: `add-text-to-slide` always replaces; the flag is ignored (see `editing-guide.md`). |
|
|
730
|
+
| **No bullet chars in text** | If shape has auto-bullets, don't add "- " or "• " |
|
|
731
|
+
| **No emoji in tables (macOS)** | Emoji renders as "A"/"Aa" — use YES/NO/[+]/[-] instead |
|
|
732
|
+
| **Extract via API only** | Use `/ppt/extract-slide-data` for tables/text/charts, NEVER scripts |
|
|
733
|
+
| **Auto-save enabled** | Changes persist automatically |
|
|
734
|
+
|
|
735
|
+
### Troubleshooting
|
|
736
|
+
|
|
737
|
+
| Error | Solution |
|
|
738
|
+
|-------|----------|
|
|
739
|
+
| `Shape not found` | Run `/ppt/analyze-slide-content` to get exact names |
|
|
740
|
+
| `No active presentation` | Call `/ppt/open-attach` first |
|
|
741
|
+
| `Slide not found` | Slide numbers are 1-based (first = 1) |
|
|
742
|
+
| `File already exists` | Generator will NOT overwrite existing files. Use different filename or ask user to confirm deletion |
|
|
743
|
+
| `Script execution timed out` (Windows only, `/ppt/execute-script`) | Break script into smaller atomic operations (<15 lines each). Complex multi-shape scripts will always timeout at the 30s limit |
|
|
744
|
+
| `Script compilation failed` (namespace, Windows only, `/ppt/execute-script`) | Verify the script uses types available in the Roslyn context. Avoid fully-qualified enum prefixes; use bare enum values (e.g., `2` instead of `PpParagraphAlignment.ppAlignCenter`) |
|
|
745
|
+
| `HRESULT E_FAIL` / COM error (Windows only, `/ppt/execute-script`) | Intermittent COM failure. Retry once; if it persists, switch to specialized API endpoints instead of scripts |
|
|
746
|
+
| SmartArt text not persisting | **Do NOT use UIA for SmartArt text.** Windows: use `/ppt/execute-script` to set SmartArt text programmatically. macOS: `/ppt/execute-script` does not exist — use regular shapes instead. See "Known Limitations" section |
|
|
747
|
+
| OneDrive sync conflict / upload failed | macOS: call `/ppt/save-presentation`. Windows: structured mutations auto-save; do not call the nonexistent endpoint or script `Save()`. If sync conflict persists, save to a local path first |
|
|
748
|
+
|
|
749
|
+
### Script Color Format (CRITICAL) — Windows only
|
|
750
|
+
|
|
751
|
+
`/ppt/execute-script` doesn't exist on macOS; this section doesn't apply there. PowerPoint COM uses **BGR** format, not RGB. When setting colors in `/ppt/execute-script`:
|
|
752
|
+
- Blue (RGB 0,102,204) → `0xCC6600` (not `0x0066CC`)
|
|
753
|
+
- Red (RGB 255,0,0) → `0x0000FF`
|
|
754
|
+
- Green (RGB 0,128,0) → `0x008000`
|
|
755
|
+
- White → `0xFFFFFF`, Black → `0x000000` (same in both formats)
|
|
756
|
+
|
|
757
|
+
Formula: `BGR = (blue << 16) | (green << 8) | red`
|
|
758
|
+
|
|
759
|
+
---
|
|
760
|
+
|
|
761
|
+
## Best Practices
|
|
762
|
+
|
|
763
|
+
### For Creation (Generator)
|
|
764
|
+
1. **Set the `subject`; use `theme: "auto"`** so themes vary across runs (see "Theme Selection"). Explicit `theme` only when the user names one.
|
|
765
|
+
2. **For custom .thmx themes**: Use `themePath` in generator options — NOT `/ppt/apply-theme`!
|
|
766
|
+
3. **Max 5-7 bullets per slide** - split if more content needed
|
|
767
|
+
4. **NO bullet characters in text** - use plain dashes (-), generator adds formatting
|
|
768
|
+
5. **NO empty lines** between plain bullet points — but **NEVER remove empty lines on timeline, feature, or custom-themed slides** (those separate content groups intentionally)
|
|
769
|
+
6. **Use appropriate layouts** for content type (see "Layout Selection by Keywords")
|
|
770
|
+
7. **Fill the slide** - content should use available space, not leave excessive whitespace
|
|
771
|
+
8. **ADD IMAGES** - search/generate images for visual appeal
|
|
772
|
+
9. **Verify once, then hand over** - Core Principle 4
|
|
773
|
+
|
|
774
|
+
### For Editing (ExecuteSkillApi)
|
|
775
|
+
1. **Always open first** - `/ppt/open-attach` before any operation
|
|
776
|
+
2. **Always analyze first** - `/ppt/analyze-slide-content` for exact shape names
|
|
777
|
+
3. **clearExistingText: true** - when replacing content (prevents doubling)
|
|
778
|
+
4. **Check themeWarning** - duplicate slides instead of inserting if present
|
|
779
|
+
5. **Format text for visual hierarchy** - after adding text, use `/ppt/format-slide-content` with `textMatch` to style sub-headers, keywords, and key phrases. See "Text Formatting for Visual Hierarchy" below.
|
|
780
|
+
6. **Verify once, then hand over** - Core Principle 4
|
|
781
|
+
7. 📄 **YOU MUST READ** `<skill-path>/editing-guide.md` for full workflow details.
|
|
782
|
+
|
|
783
|
+
### Text Structure and Spacing
|
|
784
|
+
|
|
785
|
+
When adding body text with multiple sections, use **double newlines** (`\n\n`) before sub-headers to create visual breathing room. Without spacing, content looks crowded and hard to scan.
|
|
786
|
+
|
|
787
|
+
**Good structure:**
|
|
788
|
+
```
|
|
789
|
+
Overview: Description of the model\n\nKey Features:\nFeature 1\nFeature 2\n\nUse Cases:\nUse case 1\nUse case 2
|
|
790
|
+
```
|
|
791
|
+
|
|
792
|
+
**Bad (crowded):**
|
|
793
|
+
```
|
|
794
|
+
Overview: Description\nKey Features:\nFeature 1\nFeature 2\nUse Cases:\nUse case 1
|
|
795
|
+
```
|
|
796
|
+
|
|
797
|
+
**When content has 3+ sections** (e.g., Overview + Key Features + Use Cases + Performance), split across 2 slides instead of cramming everything on one:
|
|
798
|
+
- Slide 1: Title + Overview + Key Features
|
|
799
|
+
- Slide 2: Same title + "(cont.)" + Use Cases + Performance
|
|
800
|
+
|
|
801
|
+
### Text Formatting for Visual Hierarchy
|
|
802
|
+
|
|
803
|
+
Plain unformatted text looks flat and unprofessional. Always create visual hierarchy.
|
|
804
|
+
|
|
805
|
+
**🎯 DEFAULT: `/ppt/add-html-to-slide`** — for any text edit involving bold sub-headers, mixed formatting, lists, or multiple sections. One call, native PowerPoint formatting, no post-processing. **Use this for 90% of editing operations on both macOS and Windows.**
|
|
806
|
+
|
|
807
|
+
```json
|
|
808
|
+
{"endpoint": "/ppt/add-html-to-slide", "body": {
|
|
809
|
+
"filePath": "...", "slideNumber": 5, "targetShapeName": "Content Placeholder 2",
|
|
810
|
+
"html": "<p><b>Overview</b><br>Advanced LLM by Moonshot AI</p><p><b>Key Features</b><br>Long Context: Up to 2M tokens<br>Multimodal Understanding</p><p><b>Use Cases</b><br>Document analysis<br>Code development</p>"
|
|
811
|
+
}}
|
|
812
|
+
```
|
|
813
|
+
|
|
814
|
+
**HTML patterns:**
|
|
815
|
+
- Bold sub-header + body: `<p><b>Header</b><br>Body line 1<br>Body line 2</p>`
|
|
816
|
+
- Bullet list: `<ul><li>Item 1</li><li>Item 2</li></ul>`
|
|
817
|
+
- Bold inline: `<p>Performance: <b>2x faster</b></p>`
|
|
818
|
+
- Italic for quotes: `<p><i>"Quote text"</i> — Author</p>`
|
|
819
|
+
- Multiple sections: separate with `<p>...</p>` blocks (renders with proper spacing)
|
|
820
|
+
|
|
821
|
+
**Plain text only? Use `/ppt/add-text-to-slide`** — for single-style text (titles, simple body, no formatting needed). The parameter is `targetShapeName` (NOT `shapeName`).
|
|
822
|
+
|
|
823
|
+
**Formatting text already on a slide? Use `/ppt/format-slide-content` with `textMatch`** — when you need to add bold/color/size to text that's already in a shape (e.g., from a duplicated slide):
|
|
824
|
+
```json
|
|
825
|
+
{"endpoint": "/ppt/format-slide-content", "body": {
|
|
826
|
+
"filePath": "...", "slideNumbers": [13], "shapeName": "Text Placeholder 2",
|
|
827
|
+
"textMatch": "Key Features:", "bold": true, "fontSize": 20
|
|
828
|
+
}}
|
|
829
|
+
```
|
|
830
|
+
Note: `format-slide-content` uses `shapeName` (different param naming convention from add-text/add-html, which use `targetShapeName`).
|
|
831
|
+
|
|
832
|
+
**Prefer `/ppt/add-html-to-slide` with `<b>...</b>` tags over `**...**` markers in `/ppt/add-text-to-slide`** for mixed formatting — one call instead of add-text + format-slide-content. `**...**` markers do work on both platforms. To bold a substring in text already on a slide, use `/ppt/format-slide-content` with `textMatch`.
|
|
833
|
+
|
|
834
|
+
---
|
|
835
|
+
|
|
836
|
+
## Platform-Specific Documentation
|
|
837
|
+
|
|
838
|
+
📄 **YOU MUST LOAD the appropriate platform file based on the user's OS:**
|
|
839
|
+
|
|
840
|
+
| Platform | File to Load |
|
|
841
|
+
|----------|--------------|
|
|
842
|
+
| **Windows** | `SKILL.windows.md` — ExecuteSkillApi endpoints, C# scripting |
|
|
843
|
+
| **macOS** | `SKILL.macos.md` — AppleScript-backed ExecuteSkillApi endpoint set |
|
|
844
|
+
|
|
845
|
+
### Additional Documentation (YOU MUST READ these files at the indicated trigger points)
|
|
846
|
+
|
|
847
|
+
| File | When to Read (MANDATORY) |
|
|
848
|
+
|------|--------------------------|
|
|
849
|
+
| `generator-reference.md` | **BEFORE building generator JSON** — required for correct stats/chart/table/icon format |
|
|
850
|
+
| `images-guide.md` | **BEFORE using any image layout** — required for image workflow |
|
|
851
|
+
| `editing-guide.md` | **BEFORE any editing operation** — required to prevent content duplication |
|
|
852
|
+
| `visual-styling-guide.md` | **BEFORE creating or editing any presentation** — required for professional quality |
|
|
853
|
+
| `issue-fix-mapping.md` | **WHEN health check finds issues** — required fix patterns |
|