From 322362080a7cbe5b6ac5cebb11b848161d4e9bb0 Mon Sep 17 00:00:00 2001 From: k-j-kim Date: Wed, 1 Apr 2026 12:06:36 -0700 Subject: [PATCH] fix: tighten skill descriptions to reduce false triggers - generating-ui-bundle-metadata: remove generic triggers (metadata, new app, meta XML, configuration), update command to sf template generate ui-bundle, add --template reactbasic flag - building-ui-bundle-app: reframe as orchestrator for multi-skill ui-bundle work, distinguish from generating-lightning-app --- skills/building-ui-bundle-app/SKILL.md | 2 +- skills/generating-ui-bundle-metadata/SKILL.md | 11 +++++++++-- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/skills/building-ui-bundle-app/SKILL.md b/skills/building-ui-bundle-app/SKILL.md index 4b68e0e..ecf7a7d 100644 --- a/skills/building-ui-bundle-app/SKILL.md +++ b/skills/building-ui-bundle-app/SKILL.md @@ -1,6 +1,6 @@ --- name: building-ui-bundle-app -description: "Build complete Salesforce React UI bundle applications from natural language descriptions. Use this skill when a user requests a full React app, UI bundle app, web app on Salesforce, or describes a scenario requiring scaffolding, features, data access, UI pages, and deployment of a React application hosted on Salesforce. Orchestrates all UI bundle skills in proper dependency order to produce a deployable application. Triggers on: build a React app, create a UI bundle, build me an app, full-stack Salesforce React app, create a web app on Salesforce." +description: "Orchestrator for multi-step Salesforce React UI bundle work. Use this skill when the task requires more than one ui-bundle skill — e.g. scaffolding + frontend, scaffolding + features + deployment, or any combination of 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, or generating-ui-bundle-site. Coordinates phase ordering and dependency management. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Triggers on: build a React app, build me an app on Salesforce, full-stack UI bundle app, create a web app on Salesforce, scaffold and deploy ui-bundle, ui-bundle app end to end." 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 diff --git a/skills/generating-ui-bundle-metadata/SKILL.md b/skills/generating-ui-bundle-metadata/SKILL.md index bd851fd..c97c10b 100644 --- a/skills/generating-ui-bundle-metadata/SKILL.md +++ b/skills/generating-ui-bundle-metadata/SKILL.md @@ -1,6 +1,6 @@ --- name: generating-ui-bundle-metadata -description: "Scaffold new Salesforce UI bundles and configure their metadata — sf template generate ui-bundle, UIBundle bundles (meta XML, ui-bundle.json with routing/headers/outputDir), and CSP Trusted Sites for external domains. Use whenever creating a new UI bundle, setting up UI bundle metadata structure, configuring routing or headers, setting outputDir, adding external domains that need CSP registration, or editing bundle configuration. Triggers on: create UI bundle, create ui-bundle, new app, sf template generate ui-bundle, metadata, ui-bundle.json, CSP, trusted site, bundle configuration, meta XML, routing config, external domain, headers config, outputDir." +description: "Scaffold new Salesforce UI bundles with sf template generate ui-bundle and configure ui-bundle.json (routing, headers, outputDir) and CSP Trusted Sites. Use when running sf template generate ui-bundle, editing ui-bundle.json routing/headers/outputDir, creating or modifying .uibundle-meta.xml files, or registering external domains as CSP Trusted Sites. Triggers on: sf template generate ui-bundle, ui-bundle.json, uibundle-meta.xml, outputDir, routing rewrites, routing redirects, routing fallback, trailingSlash, CSP trusted site, cspTrustedSite, external domain CSP." --- # UI Bundle Metadata @@ -9,7 +9,14 @@ description: "Scaffold new Salesforce UI bundles and configure their metadata Use `sf template generate ui-bundle` to create new apps — not create-react-app, Vite, or other generic scaffolds. -**UI bundle name (`-n`):** Alphanumerical only — no spaces, hyphens, underscores, or special characters. Example: `CoffeeBoutique` (not `Coffee Boutique`). +**Always pass `--template reactbasic`** to scaffold a React-based bundle. + +**UI bundle name (`-n`):** Alphanumerical only — no spaces, hyphens, underscores, or special characters. + +**Example:** +```bash +sf template generate ui-bundle -n CoffeeBoutique --template reactbasic +``` After generation: 1. Replace all default boilerplate — "React App", "Vite + React", default ``, placeholder text