feat: @W-22259678@ changes with clt ref to mosaic rendition guidance by sowmya-sriram · Pull Request #190 · forcedotcom/afv-library

sowmya-sriram · 2026-04-10T07:54:08Z

References: Contributing guide · Skill authoring guide · Agent Skills spec

@W-22259678@

What changed

Created widget-rendition.md as a reference for generating-custom-lightning-type skill
Update generating-custom-lightning-type skill to use above reference
Deleted generating-fragment skill

Why

Support widget rendition for CLTs

Notes

Skills

Manual checklist

Description quality

Describes what the skill does and the expected output
Includes relevant Salesforce domain keywords (Apex, LWC, SOQL, metadata types, etc.)
Trigger phrases are specific enough for Vibes to select this skill reliably

Instructions

Clear goal statement
Step-by-step workflow
Validation rules for generated output
Defined output / artifact

Context efficiency

Core instructions are concise — supporting material lives in templates/, examples/, or docs/ subdirectories
No unnecessary background explanation in the body

Automated checks

Enforced by CI (npm run validate:skills) per the Agent Skills spec:

Directory is one level deep, named in kebab-case (max 64 chars), contains SKILL.md
Frontmatter name matches directory name; description is present, ≥ 20 words, ≤ 1024 characters, and includes trigger language
Body is non-empty and under 500 lines
Name uses gerund form ⚠ (warning — does not block merge)

manoj-dasari

Looks good to me.

hsinghbisht-sfdc · 2026-04-27T10:36:18Z

@@ -1,6 +1,8 @@
 ---
 name: generating-custom-lightning-type
-description: "Use this skill when users need to create Custom Lightning Types (CLTs) for Einstein Agent actions or structured input/output schemas. Trigger when users mention CLT, Custom Lightning Types, JSON schemas for agents, type definitions, lightning__objectType, or editor/renderer configurations. This is complex - always use this skill for CLT work."
+description: "Use this skill when users need to create Custom Lightning Types (CLTs) for Einstein Agent actions or structured input/output schemas. Trigger when users mention CLT, Custom Lightning Types,
+   Custom Lightning Types (CLTs) with widget/mosaic/fragment rendition/renderer, JSON schemas for agents, type definitions, lightning__objectType, or editor/renderer configurations. When widget renditions are requested, you


Looks like you have some extra new line characters in the description, Can you please write the description together.

hsinghbisht-sfdc · 2026-04-27T10:43:33Z

-description: "Use this skill when users need to create Custom Lightning Types (CLTs) for Einstein Agent actions or structured input/output schemas. Trigger when users mention CLT, Custom Lightning Types, JSON schemas for agents, type definitions, lightning__objectType, or editor/renderer configurations. This is complex - always use this skill for CLT work."
+description: "Use this skill when users need to create Custom Lightning Types (CLTs) for Einstein Agent actions or structured input/output schemas. Trigger when users mention CLT, Custom Lightning Types,
+   Custom Lightning Types (CLTs) with widget/mosaic/fragment rendition/renderer, JSON schemas for agents, type definitions, lightning__objectType, or editor/renderer configurations. When widget renditions are requested, you
+   MUST first read the widget-rendition.md reference file in this skill's references/ directory and follow its complete workflow. This is complex - always use this skill for CLT work."


Are you expecting to read widget-rendition.md before executing this Skill?

Yes, it fetches generating-custom-lightning-type skill and reads widget-rendition.md when the user prompt requests for widget rendition. It would be fine to read widget-rendition.md at the stage when it is actually required but I observed that AFV was not picking it up if not enforced in the description.

hsinghbisht-sfdc · 2026-04-27T10:46:19Z

@@ -57,26 +60,26 @@ Custom Lightning Types (CLTs) are JSON Schema-based type definitions used by the

 ## Primitive Types & Constraints


Priortize to use progressive disclosure and you can put this inside /assets

@hsinghbisht-sfdc This is owned by TSE team. cc: @manoj-dasari

Will fix this in an upcoming PR. Creating a backlog WI to track.

hsinghbisht-sfdc · 2026-04-27T10:48:19Z

-   - Run a final schema sanity check before deploy: valid `lightning:type` names, required fields present, and no disallowed keywords.
-   - Deploy the bundle using your org's standard metadata deployment flow (e.g. Salesforce CLI or IDE). The MCP client or tooling in use should provide or integrate with the appropriate deploy/retrieve commands for Lightning Type bundles.
-   - Validate incrementally: if deployment fails, remove disallowed keywords first (especially `examples`, `items`, nested `lightning:type`).
+    - Deploy the bundle using your org's standard metadata deployment flow (e.g. Salesforce CLI or IDE). The MCP client or tooling in use should provide or integrate with the appropriate deploy/retrieve commands for Lightning Type bundles.


Please do not instruct Deploy in the Skills.
This instruction is outside the boundary of Skills.

This is owned by TSE team.
cc: @manoj-dasari

Will fix this in an upcoming PR. Creating a backlog WI to track.

hsinghbisht-sfdc · 2026-04-30T12:06:41Z

@sowmya-sriram you have merge conflicts.

sowmya-sriram · 2026-05-05T05:26:39Z

@sowmya-sriram you have merge conflicts.

@hsinghbisht-sfdc resolved merge conflicts, please take a look.

changes with clt ref to mosaic rendition

0e22a65

sowmya-sriram changed the title ~~changes with clt ref to mosaic rendition~~ changes with clt ref to mosaic rendition guidance Apr 10, 2026

updated widget rendition guidance

4790532

sowmya-sriram changed the base branch from main to develop April 20, 2026 07:55

sowmya-sriram marked this pull request as ready for review April 20, 2026 08:01

sowmya-sriram changed the title ~~changes with clt ref to mosaic rendition guidance~~ @W-22134404 changes with clt ref to mosaic rendition guidance Apr 20, 2026

hsinghbisht-sfdc force-pushed the develop branch 2 times, most recently from 88e49f5 to 2d508c8 Compare April 21, 2026 09:13

sowmya-sriram changed the title ~~@W-22134404 changes with clt ref to mosaic rendition guidance~~ feat: @W-22134404@ changes with clt ref to mosaic rendition guidance Apr 23, 2026

manoj-dasari approved these changes Apr 24, 2026

View reviewed changes

hsinghbisht-sfdc force-pushed the develop branch from 2d508c8 to 119dc66 Compare April 26, 2026 15:33

hsinghbisht-sfdc reviewed Apr 27, 2026

View reviewed changes

removed new line characters from description.

aae35b7

Merge upstream/develop into inline-mosaic-poc

e78565f

Merge branch 'develop' into inline-mosaic-poc

98895b6

sowmya-sriram changed the title ~~feat: @W-22134404@ changes with clt ref to mosaic rendition guidance~~ feat: @W-22259678@ changes with clt ref to mosaic rendition guidance May 5, 2026

sowmya-sriram added 2 commits May 5, 2026 14:17

Merge branch 'develop' into inline-mosaic-poc

0221ed5

added back version metadata

48162c3

hsinghbisht-sfdc approved these changes May 5, 2026

View reviewed changes

hsinghbisht-sfdc merged commit 5d33d63 into forcedotcom:develop May 5, 2026
2 checks passed

		@@ -57,26 +60,26 @@ Custom Lightning Types (CLTs) are JSON Schema-based type definitions used by the

		## Primitive Types & Constraints

Conversation

sowmya-sriram commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed

Why

Notes

Skills

Manual checklist

Automated checks

Uh oh!

manoj-dasari left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hsinghbisht-sfdc commented Apr 30, 2026

Uh oh!

sowmya-sriram commented May 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

sowmya-sriram commented Apr 10, 2026 •

edited

Loading

manoj-dasari left a comment •

edited

Loading