fix: rename building-ui-bundle-frontend to editing-ui-bundle-frontend

The "building" prefix caused skill selection confusion with
building-ui-bundle-app when the intent classifier tagged requests as
"app". Renaming to "editing" clearly distinguishes modify-existing-app
from create-new-app workflows. Also expanded trigger words in the
description for better matching.

Updated cross-references in building-ui-bundle-app and
generating-ui-bundle-metadata.
This commit is contained in:
ysachdeva@salesforce.com 2026-04-03 18:49:34 +05:30
parent dbd471aa45
commit 9083bf66e8
6 changed files with 9 additions and 9 deletions

View File

@ -1,9 +1,9 @@
---
name: building-ui-bundle-app
description: "MUST activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end. This is the orchestrator that coordinates scaffolding, features, data access, frontend UI, integrations, and deployment in the correct dependency order. Without it, phases execute out of order and the app breaks. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Do NOT use for single-concern edits to an existing page (use building-ui-bundle-frontend)."
description: "MUST activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end. This is the orchestrator that coordinates scaffolding, features, data access, frontend UI, integrations, and deployment in the correct dependency order. Without it, phases execute out of order and the app breaks. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Do NOT use for single-concern edits to an existing page (use editing-ui-bundle-frontend)."
metadata:
version: "1.0"
related-skills: generating-ui-bundle-metadata, generating-ui-bundle-features, using-ui-bundle-salesforce-data, building-ui-bundle-frontend, implementing-ui-bundle-agentforce-conversation-client, implementing-ui-bundle-file-upload, deploying-ui-bundle, generating-experience-react-site
related-skills: generating-ui-bundle-metadata, generating-ui-bundle-features, using-ui-bundle-salesforce-data, editing-ui-bundle-frontend, implementing-ui-bundle-agentforce-conversation-client, implementing-ui-bundle-file-upload, deploying-ui-bundle, generating-experience-react-site
---
# Building a UI Bundle App
@ -29,7 +29,7 @@ Build a complete, deployable Salesforce React UI bundle application from a natur
**Do NOT use when:**
- Creating a single page or component (use `building-ui-bundle-frontend`)
- Creating a single page or component (use `editing-ui-bundle-frontend`)
- Only installing a feature (use `generating-ui-bundle-features`)
- Only setting up data access (use `using-ui-bundle-salesforce-data`)
- Only deploying an existing app (use `deploying-ui-bundle`)
@ -190,7 +190,7 @@ SKILL LOAD ORDER:
1. generating-ui-bundle-metadata
2. generating-ui-bundle-features (if features needed)
3. using-ui-bundle-salesforce-data (if data access needed)
4. building-ui-bundle-frontend
4. editing-ui-bundle-frontend
5a. implementing-ui-bundle-agentforce-conversation-client (if chat requested)
5b. implementing-ui-bundle-file-upload (if file upload requested)
6. deploying-ui-bundle
@ -231,7 +231,7 @@ Execute each phase sequentially. Complete all steps within a phase before moving
- 4. Checkpoint: Data layer ready -- proceed to Phase 4
**Phase 4 -- UI**
- 1. Load skill: Invoke `building-ui-bundle-frontend`
- 1. Load skill: Invoke `editing-ui-bundle-frontend`
- 2. Execute: Build layout, pages, components, navigation. Replace all boilerplate.
- 3. Verify: Run lint and build -- 0 errors required
- 4. Checkpoint: UI complete -- proceed to Phase 5
@ -322,4 +322,4 @@ Every generated app must feel purpose-built. Replace "React App" titles, "Vite +
### 3. Design with Intent
Follow the design thinking and frontend aesthetics guidance from `building-ui-bundle-frontend`. Every app should have a clear visual direction -- not generic defaults.
Follow the design thinking and frontend aesthetics guidance from `editing-ui-bundle-frontend`. Every app should have a clear visual direction -- not generic defaults.

View File

@ -1,6 +1,6 @@
---
name: building-ui-bundle-frontend
description: "MUST activate before editing ANY file under uiBundles/*/src/ for visual or UI changes to an EXISTING app — pages, components, sections, layout, styling, colors, fonts, navigation, animations, or any look-and-feel change. Use this skill when modifying pages, components, layout, styling, or navigation in an existing UI bundle app. Activate when the project contains appLayout.tsx, routes.tsx, src/pages/, src/components/, or global.css. This skill contains critical project-specific conventions (appLayout.tsx shell, shadcn/ui components, Tailwind CSS, Salesforce base-path routing, module restrictions) that override general knowledge. Without this skill, generated code will use wrong imports, break routing, or ignore project structure. Do NOT use when creating a new app from scratch (use building-ui-bundle-app instead)."
name: editing-ui-bundle-frontend
description: "MUST activate before editing, modifying, updating, or adding to ANY file under uiBundles/*/src/ for an EXISTING app — adding pages, editing components, changing sections, updating layout, modifying styling, adjusting colors, switching fonts, fixing navigation, adding animations, or any look-and-feel change. Use this skill when the user wants to add a page, edit a page, modify a component, change styling, update navigation, add a form, customize layout, adjust theme, or tweak UI in an existing UI bundle app. Activate when the project already contains appLayout.tsx, routes.tsx, src/pages/, src/components/, or global.css. This skill contains critical project-specific conventions (appLayout.tsx shell, shadcn/ui components, Tailwind CSS, Salesforce base-path routing, module restrictions) that override general knowledge. Without this skill, generated code will use wrong imports, break routing, or ignore project structure. Do NOT use when creating a brand-new app from scratch (use building-ui-bundle-app instead)."
---
# UI Bundle UI

View File

@ -21,7 +21,7 @@ sf template generate ui-bundle -n CoffeeBoutique --template reactbasic
After generation:
1. Replace all default boilerplate — "React App", "Vite + React", default `<title>`, placeholder text
2. Populate the home page with real content (landing section, banners, hero, navigation)
3. Update navigation and placeholders (see the `building-ui-bundle-frontend` skill)
3. Update navigation and placeholders (see the `editing-ui-bundle-frontend` skill)
Always install dependencies before running any scripts in the UI bundle directory.