fix: default skill examples to cloud.uipath.com, keep alpha as non-prod only

[gabrielavaduva]

Problem

Some skills referenced alpha.uipath.com as a default or generic example URL. alpha.uipath.com is an internal/pre-production environment and should not be surfaced to users as an example or default. See PILOT-6377.

Change

Switched every spot where alpha was the default/primary example to cloud.uipath.com (production). alpha is retained only where it is explicitly labeled as a non-production example or appears in an environment-mapping reference table alongside cloud — consistent with the guidance that alpha may be shown as a non-prod example, but the default must be cloud.

Fixed (alpha-as-default → cloud)

File	Change
uipath-tasks/SKILL.md	Primary login example → production default; alpha kept as labeled non-prod example
uipath-insights/SKILL.md	Production default first; alpha as non-prod example
uipath-platform/SKILL.md	Sample .auth UIPATH_URL= → cloud.uipath.com
uipath-governance/.../auth-context.md	"Available fields" table UIPATH_URL example → cloud
uipath-human-in-the-loop/.../hitl-node-apptask.md	UIPATH_URL comment example → cloud
uipath-coded-apps/.../state-file.md	Sample state env/cloudUrl → cloud
uipath-coded-apps/.../build/impl.md	Deployed-app-base example → cloud
uipath-coded-apps/.../build-dashboard.mjs	JSDoc cloudUrl/apiUrl examples → cloud / api.uipath.com
uipath-api-workflow/.../troubleshooting.md	Two "StudioWeb (alpha…)" / browser references → cloud

Intentionally left as-is

• Lines explicitly commented # non-prod / # non-production environments / # alpha (governance, coded-apps SKILL, maestro-flow, rpa, agents)
• Environment-mapping reference tables that list cloud alongside alpha/staging (patterns.md, debug.md, oauth-client-setup.md, action-center-urls.md, cors-error playbook, sdd-generation-guide.md)
• Option lists where Production is the stated default (agents authentication.md, tasks SKILL.md)
• uipath-maestro-bpmn/.../expected-findings/demo.bpmn — validator test fixture data, not user-facing docs

Acceptance criteria

• No skill uses alpha.uipath.com as a default or generic example URL
• Defaults and primary examples reference cloud.uipath.com
• alpha retained only as an explicit non-prod example / mapping-table entry

🤖 Generated with Claude Code

[github-actions]

Claude finished @gabrielavaduva's task in 2m 20s —— View job

---

PR Review: Default skill examples to cloud.uipath.com

• Read review criteria and project conventions
• Read full diff (9 files, +18/−12)
• Read existing PR conversation (no prior comments)
• Review each changed file in full context
• Check for cross-skill references, secrets, broken links
• Post final review

---

Summary

Straightforward URL-hygiene fix: replaces alpha.uipath.com with cloud.uipath.com in 9 files where alpha was used as the default/primary example. Alpha is retained only in lines explicitly labeled as non-production or in environment-mapping tables. No behavioral, structural, or frontmatter changes.

Change-by-Change Review

1. skills/uipath-tasks/SKILL.md — login examples

OK. Adds a production-default uip login --tenant MyTenant line with a clear comment, then relabels the alpha line as "non-production environment." The three-option list above (line 27) already shows Alpha/Staging/Production, so the code block now matches the prose. Clean.

2. skills/uipath-insights/SKILL.md — login examples

OK. Identical pattern to the tasks change — production default first, alpha relabeled. Consistent with the tasks skill.

3. skills/uipath-platform/SKILL.md — sample .auth file

OK. UIPATH_URL=https://cloud.uipath.com is the correct production value. The "custom authority" section at line 119 still references alpha, which is correct since it's explicitly labeled as a non-default case.

4. skills/uipath-governance/references/auth-context.md — "Available fields" table

OK. Example cell for UIPATH_URL changed to https://cloud.uipath.com. Single-cell change in a reference table — clean.

5. skills/uipath-human-in-the-loop/references/hitl-node-apptask.md — comment in code block

OK. Comment example # UIPATH_URL — e.g. https://cloud.uipath.com — purely illustrative, correct.

6. skills/uipath-coded-apps/references/dashboards/primitives/state-file.md — state JSON

OK. "env": "cloud" and "cloudUrl": "https://cloud.uipath.com" — both consistent with the environment-mapping table in impl.md:29-31.

7. skills/uipath-coded-apps/references/dashboards/plugins/build/impl.md — deployed-app example

OK. Example URL changed to https://cloud.uipath.com/acme/portal_. The env-mapping table at line 29 (which still shows alpha as a row alongside cloud) is intentionally unchanged — consistent with the PR's scope.

8. skills/uipath-coded-apps/assets/scripts/dashboards/build-dashboard.mjs — JSDoc

OK. cloudUrl example → https://cloud.uipath.com, apiUrl → https://api.uipath.com. The api.uipath.com value (not cloud.api.uipath.com) is correct per the mapping rule in impl.md:33 ("Exception: cloud.uipath.com → api.uipath.com").

9. skills/uipath-api-workflow/references/troubleshooting.md — two prose references

OK. Line 189: "StudioWeb (cloud.uipath.com)" — correctly identifies the production StudioWeb URL. Line 517: "browser is using at cloud.uipath.com" — same pattern. Both are generic/default references, not environment-specific guidance.

What's Missing

Nothing identified. The PR's scope is well-defined (alpha-as-default → cloud) and the "intentionally left as-is" list in the description is accurate — I verified all remaining alpha.uipath.com references are in explicitly labeled non-prod contexts, env-mapping tables, or option lists.

Area Ratings

Area	Status	Notes
Frontmatter	OK	No frontmatter changes — name/description fields untouched
E2E Tests	OK	No behavioral changes — existing tests unaffected
Skill Body	OK	Login examples improved (production-first, alpha relabeled)
References & Assets	OK	All URL changes consistent with env-mapping conventions
Repo Hygiene	OK	No secrets, no cross-skill refs, scoped changes only

Issues for Manual Review

None found.

Conclusion

Clean, well-scoped fix. All nine changes are correct and consistent with each other and with the env-mapping conventions already established in the codebase. No issues found — this is ready to merge.

---

[rliuup]

Audit re-grep across the repo confirms every remaining alpha.uipath.com reference is policy-compliant: either an environment-mapping table row (listed alongside cloud/staging) or a line explicitly labeled non-prod. No missed alpha-as-default examples. Clean, well-scoped fix.