docs(uipath-troubleshoot): add Word Activities package + Add Picture playbook

[Stefan-Virgil]

What

Seeds a new word-activities package in the uipath-troubleshoot knowledge base with the first playbook for UiPath.Word.Activities.WordAddImage ("Add Picture" in Studio).

There was no Word activities package before this — these are the inaugural files for UiPath.Word.Activities.

Files

File	Purpose
references/activity-packages/word-activities/overview.md	Package execution model (Use Word File / Word Application Scope, Office COM interop, file-based Word Document fallback) + Add Picture behaviour chain
references/activity-packages/word-activities/playbooks/add-picture-failures.md	One medium-confidence playbook covering all four failure modes
references/activity-packages/word-activities/summary.md	Package playbook index
references/summary.md	Adds the Word Activities router section after Excel

Playbook design

Per request, the four failure categories are consolidated into a single playbook using the ## Causes C1–C4 pattern (as in click-coordinate-off-screen.md), with a classification decision tree in ## Investigation and per-cause fixes in ## Resolution:

• C1 — activity placed outside a Use Word File / Word Application Scope
• C2 — Word COM interop exception (0x8002801D type library unregistered / 0x8001010A application busy): orphaned WINWORD.EXE, bitness mismatch, or unregistered Office COM libraries
• C3 — insertion target (text/bookmark) not found in the open document
• C4 — invalid path, or an in-memory UiPath.Core.Image bound to Picture to insert instead of a path string

Notes

• Discoverable via the references/summary.md router → package summary.md → playbook (no SKILL.md change needed).
• Summary confidence column matches the playbook frontmatter (medium).
• CODEOWNERS already covers /skills/uipath-troubleshoot/ — no update required.
• Docs-only change; no code or tests affected.

🤖 Generated with Claude Code

[github-actions]

Claude finished @Stefan-Virgil's task in 3m 7s —— View job

---

Review: PR #1439 — Word Activities package + Add Picture playbook

• Read review guidelines and project conventions
• Read full diff and all 4 changed files
• Verify relative links resolve
• Check for cross-skill references, secrets, personal paths
• Check consistency with existing patterns (Excel Activities)
• Post review findings

---

Summary

Adds a new word-activities package to the uipath-troubleshoot knowledge base with an overview, a consolidated multi-cause playbook for Add Picture (WordAddImage) failures, a package summary, and a router entry in references/summary.md. Clean, well-structured addition that closely follows the established Excel Activities pattern.

Change-by-Change Review

1. references/activity-packages/word-activities/overview.md (+31)

OK

Package overview follows the exact structure of the Excel Activities overview: intro paragraph → execution model (behaviour chain) → key properties → ## Common Failure Patterns → ## Package. Four failure categories (scope, COM, target, path) are described with enough detail for agent routing. The behaviour chain numbered list is clear and prescriptive.

2. references/activity-packages/word-activities/playbooks/add-picture-failures.md (+55)

OK

Consolidated multi-cause playbook follows the established C1–C4 pattern (as in click-coordinate-off-screen.md). Structure: Context (symptoms + four mechanisms) → Causes → Investigation (decision tree) → Resolution (per-cause fixes). Frontmatter confidence: medium is appropriate for the breadth of causes. The investigation decision tree is well-structured — "stop at the first match" is the right instruction for an agent. Resolutions are prescriptive with specific actions (not vague "consider" language). The C1 variant about Invoke Workflow File boundary is a valuable addition not present in the overview.

3. references/activity-packages/word-activities/summary.md (+7)

OK

Package playbook index with overview link and single-row table. Matches the Excel Activities summary pattern. Confidence column (Medium) matches the playbook frontmatter.

4. references/summary.md (+9)

OK

Router entry added after Excel Activities, before the ## Playbooks section. Consistent with the existing activity-package entries: paragraph description → namespace → overview + summary links. Placement alongside Excel makes sense — both are COM/Office interop packages.

What's Missing

Nothing identified. This is a docs-only change within an existing skill's reference tree — no SKILL.md modification needed, CODEOWNERS already covers the path, and no tests are required (reference docs within an existing knowledge base, not a new skill or behavioral change).

Area Ratings

Area	Status	Notes
Frontmatter	OK	Playbook has valid confidence: medium
E2E Tests	N/A	Docs-only reference addition to existing skill
Skill Body	N/A	No SKILL.md changes
References & Assets	OK	All 4 files follow established conventions; all links resolve
Repo Hygiene	OK	No secrets, no cross-skill refs, CODEOWNERS already covers path

Issues for Manual Review

• Domain accuracy of COM HRESULTs: The playbook cites 0x8002801D (TYPE_E_LIBNOTREGISTERED) and 0x8001010A (RPC_E_SERVERCALL_RETRYLATER) as the primary COM error codes for Word interop failures. These are standard Windows COM HRESULTs and appear correct, but the reviewer should verify they match the actual error codes observed in UiPath Word Activities support cases.
• Invoke Workflow File boundary behavior (C1 variant): The playbook states that scope context does not cross the Invoke Workflow File boundary implicitly. This is a known UiPath behavior but worth verifying against current runtime versions.

Conclusion

Clean PR. Follows the established Excel Activities pattern consistently across all four files. Playbook is well-structured with a clear decision tree and prescriptive resolutions. No blocking issues found — approve.