feat: update theme layout creation instructions#122
Open
jeffcarey wants to merge 2 commits intoforcedotcom:mainfrom
Open
feat: update theme layout creation instructions#122jeffcarey wants to merge 2 commits intoforcedotcom:mainfrom
jeffcarey wants to merge 2 commits intoforcedotcom:mainfrom
Conversation
scottmo
reviewed
Mar 27, 2026
| **Steps** (Follow the steps sequentially. Do not skip any step before proceeding): | ||
|
|
||
| - [ ] MUST read [handle-ui-components.md](docs/handle-ui-components.md) to add LWCs to LWR sites. | ||
| - [ ] MUST read [handle-ui-components.md](docs/handle-ui-components.md) for new theme layouts. |
Contributor
There was a problem hiding this comment.
This is not just for theme layout tho. We also need it to add LWCs to regular pages.
Contributor
Author
There was a problem hiding this comment.
Oops-- will revert this part as the other update is the one that I think is more effective
fcwong
approved these changes
Mar 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
References: Contributing guide · Skill authoring guide · Agent Skills spec
What changed
More strongly encourages the LLM to check whether the user wants to create a new LWC when creating a theme layout for Experience Cloud LWR sites.
Also removes some Roman numeral section annotations which are no longer present/needed.
Why
Without this update, it would often skip component creation which would yield a useless result.
Notes
Skills
Manual checklist
Description quality
Instructions
Context efficiency
templates/,examples/, ordocs/subdirectoriesAutomated checks
Enforced by CI (
npm run validate:skills) per the Agent Skills spec:SKILL.mdnamematches directory name;descriptionis present, ≥ 20 words, ≤ 1024 characters, and includes trigger language