workflow-editor-shadow-dom-readiness

Align Playwright locators with Shadow DOM readiness attributes in custom web components.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill workflow-editor-shadow-dom-readiness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-editor-shadow-dom-readiness
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/workflow-editor-shadow-dom-readiness
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill workflow-editor-shadow-dom-readiness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves intermittent test failures where automated smoke tests fail to detect readiness markers because they are hidden inside a custom element's Shadow DOM.

Core Features & Use Cases

  • Shadow DOM Awareness: Provides patterns to correctly target readiness markers within encapsulated web components.
  • Test Stability: Prevents false negatives in Playwright or similar test frameworks by aligning selector strategies with component architecture.
  • Use Case: When a workflow editor component is refactored into a Shadow DOM host, use this Skill to update your test locators to ensure the editor is fully loaded before proceeding with interaction steps.

Quick Start

Apply the shadow dom readiness pattern to your test suite by updating the selector to target the custom element host or using a shadow-aware locator.

Frequently Asked Questions about workflow-editor-shadow-dom-readiness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do my Playwright tests fail when targeting web components inside a Shadow DOM?

Playwright tests fail because Shadow DOM encapsulation hides readiness markers from standard document-level queries. You must use shadow-aware locators to target the custom element host instead of standard selectors to ensure the component is fully loaded.

How do I fix test flakiness caused by selector drift in Shadow DOM custom elements?

Fix selector drift by aligning Playwright locators with component-specific readiness attributes. Targeting the custom element host directly bypasses encapsulation boundaries, preventing false negatives during automated smoke testing workflows.

How do I access readiness markers encapsulated within a workflow editor's Shadow DOM?

Access readiness markers by updating your test selector to target the custom element host or using a shadow-aware locator. This aligns your query strategy with the component architecture to detect when the editor is fully loaded.

Can I use standard CSS selectors to automate UI testing for Shadow DOM web components?

Standard CSS selectors cannot pierce Shadow DOM encapsulation to find readiness markers. You must apply shadow-aware locator patterns in Playwright to interact with custom web components and achieve stable test execution.

What's the best way to automate smoke tests for a workflow editor refactored into a Shadow DOM host?

Automate smoke tests by updating test locators to target the custom element host rather than internal elements. This shadow-aware pattern ensures the workflow editor component reports readiness accurately before proceeding with interaction steps.