forcedotcom/sf-skills / plugins/builder/experience-lwc/skills/experience-lwc-legacy-migrate
experience-lwc-legacy-migrate
VerifiedMigrate legacy Salesforce UI stacks onto modern LWC — Aura → LWC conversion completeness verification and Lightning Out Beta → Lightning Out 2.0 host-page migration. TRIGGER on "verify Aura to LWC migration completeness", "migrate Lightning Out Beta to LO 2.0", "upgrade $Lightning.use() to <lightning-out-application>", "replace hardcoded LO tokens with OAuth PKCE", "write an LO 2.0 host page", or an external Lightning Out page that stopped rendering; also `.cmp`/`.js-meta.xml` files alongside LWC. DO NOT TRIGGER for the initial Aura-to-LWC conversion (use experience-aura-lwc-migrate), a React-to-LWC migration, or building a new LWC (use experience-lwc-design-generate).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.1 KB |
| assets/lo20-host-page-template.html | other | 6.8 KB |
| references/aura-to-lwc-completeness-checklist.md | markdown | 7.9 KB |
| references/lightning-out-2-system-reference.md | markdown | 22.3 KB |
| references/lightning-out-beta-to-2-migration.md | markdown | 24.8 KB |
| scripts/convert-lo-names.pyexecutable | script | 3.3 KB |
| scripts/validate-lo20-page.pyexecutable | script | 5.6 KB |
scripts/validate-lo20-page.py
View on GitHub#!/usr/bin/env python3
"""Mechanically validate a migrated Lightning Out 2.0 host page.
The six non-negotiable LO 2.0 rules (Workflow B, Step B4) plus the core
library/component checklist items are all *deterministic code-structure*
checks. This script runs them against a migrated HTML host page so the
workflow gates on a repeatable pass/fail instead of prose interpretation.
Usage:
python3 scripts/validate-lo20-page.py <path-to-migrated.html>
Prints one PASS/FAIL line per rule. Exits 0 only when every rule passes;
exits 1 if any rule fails, 2 on a usage/IO error.
"""
import re
import sys
def check(src: str):
"""Return a list of (ok: bool, label: str, detail: str)."""
results = []
def add(ok, label, detail=""):
results.append((ok, label, detail))
# --- Library / Beta removal -------------------------------------------
# Locate the versioned library path, then scan back to the opening
# <script to check for `async`. We do NOT isolate the tag with [^>]*
# because placeholder URLs like https://<DOMAIN>.my.salesforce.com
# legitimately contain a '>' inside the attribute value.
lib_path = "lightning.out.latest/index.iife.prod.js"
idx = src.find(lib_path)
has_lo2_lib = idx != -1
lib_async = False
if has_lo2_lib:
start = src.rfind("<script", 0, idx)
if start != -1:
lib_async = bool(re.search(r"\basync\b", src[start:idx]))
add(has_lo2_lib and lib_async, "LO 2.0 library script tag",
"must load .../lightning.out.latest/index.iife.prod.js with `async`")
beta_lib = bool(re.search(r"lightning\.force\.com/[^\"']*lightning\.out\.js", src))
beta_calls = bool(re.search(r"\$Lightning\.(use|createComponent)", src))
add(not beta_lib and not beta_calls, "No Lightning Out Beta remnants",
"no lightning.out.js / $Lightning.use / $Lightning.createComponent")
# --- Rule 1: customElements.whenDefined must use a literal string ------
wd = re.findall(r"customElements\.whenDefined\(\s*([^)]*?)\s*\)", src)
if not wd:
add(False, "Rule 1: whenDefined literal string",
"no customElements.whenDefined(...) call found")
else:
# Require the ENTIRE trimmed argument to be a single quoted string
# literal. A prefix-only check (starts with a quote) would let
# expressions like `'c-' + componentTag` slip through.
all_literal = all(
re.fullmatch(r"""(['"]).*?\1""", arg.strip()) for arg in wd)
add(all_literal, "Rule 1: whenDefined literal string",
"argument must be a quoted string, not the `components` variable")
# --- Rule 2: mountLo20 declared with two parameters -------------------
decl = re.search(r"function\s+mountLo20\s*\(([^)]*)\)", src)
if not decl:
add(False, "Rule 2: mountLo20(frontdoorUrl, orgUrl)",
"no `function mountLo20(...)` declaration found")
else:
params = [p for p in decl.group(1).split(",") if p.strip()]
add(len(params) == 2, "Rule 2: mountLo20(frontdoorUrl, orgUrl)",
f"declaration has {len(params)} parameter(s), expected 2")
# --- Rule 3: clearCachedResult present (called before mounting) -------
add(bool(re.search(r"clearCachedResult\s*\(", src)),
"Rule 3: clearCachedResult() before mount",
"clearCachedResult() must run before every mountLo20() call")
# --- Rule 4: every mountLo20 call passes two arguments ----------------
calls = re.findall(r"(?<!function\s)\bmountLo20\s*\(([^)]*)\)", src)
# Count args for EVERY call site (the declaration is excluded by the
# lookbehind). Do NOT skip empty argument lists: a zero-arg
# `mountLo20()` has an arg count of 0, which is != 2 and must fail.
bad_calls = [c for c in calls
if len([a for a in c.split(",") if a.strip()]) != 2]
add(len(bad_calls) == 0, "Rule 4: mountLo20 calls pass two args",
f"{len(bad_calls)} call(s) do not pass exactly two arguments")
# --- Rule 5: boot() wrapper defined and invoked -----------------------
boot_def = bool(re.search(r"function\s+boot\s*\(", src))
boot_call = bool(re.search(r"(?<!function\s)\bboot\s*\(\s*\)", src))
add(boot_def and boot_call, "Rule 5: boot() wrapper",
"define function boot() and call boot() once at the end")
# --- Rule 6: component tag has no inline display style ----------------
comp_tags = re.findall(r"<c-[a-z0-9-]+[^>]*>", src)
add(len(comp_tags) > 0, "Component tag present",
"expected a <c-...> custom element in the HTML")
inline_hidden = any(re.search(r"style\s*=\s*['\"][^'\"]*display\s*:\s*none",
t) for t in comp_tags)
add(not inline_hidden, "Rule 6: no inline display:none on component tag",
"control visibility via the loading indicator, not the component tag")
return results
def main(argv=None) -> int:
argv = argv if argv is not None else sys.argv[1:]
if len(argv) != 1:
print("usage: validate-lo20-page.py <path-to-migrated.html>",
file=sys.stderr)
return 2
try:
with open(argv[0], "r", encoding="utf-8") as fh:
src = fh.read()
except OSError as e:
print(f"error: cannot read {argv[0]}: {e}", file=sys.stderr)
return 2
results = check(src)
failed = 0
for ok, label, detail in results:
mark = "PASS" if ok else "FAIL"
line = f"[{mark}] {label}"
if not ok and detail:
line += f" -- {detail}"
print(line)
if not ok:
failed += 1
print(f"\n{len(results) - failed}/{len(results)} checks passed")
return 0 if failed == 0 else 1
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |