Skip to content

ensure skill load for guest sharing rule#127

Open
b94901099 wants to merge 3 commits intoforcedotcom:mainfrom
b94901099:main
Open

ensure skill load for guest sharing rule#127
b94901099 wants to merge 3 commits intoforcedotcom:mainfrom
b94901099:main

Conversation

@b94901099
Copy link
Copy Markdown

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

What changed

Update the skill description for generating-experience-lwr-site so AFV will load it for guest sharing rule creation.
@W-21787886@

Why

Make the instruction explicit.

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)

@salesforce-cla
Copy link
Copy Markdown

Thanks for the contribution! Before we can merge this, we need @b94901099 to sign the Salesforce Inc. Contributor License Agreement.

Made-with: Cursor
---
name: generating-experience-lwr-site
description: "Creates, modifies, or manages Salesforce Experience Cloud LWR sites via DigitalExperience metadata. Always trigger when users mention Experience sites, LWR sites, DigitalExperience, Experience Cloud, community sites, portals, creating pages, adding routes, views, theme layouts, branding sets, previewing sites, or any DigitalExperience bundle work. Also use when users mention specific content types like sfdc_cms__route, sfdc_cms__themeLayout, etc. or when troubleshooting site deployment."
description: "Creates, modifies, or manages Salesforce Experience Cloud LWR sites via DigitalExperience metadata. Always trigger when users mention Experience sites, LWR sites, DigitalExperience, Experience Cloud, community sites, portals, creating pages, adding routes, views, theme layouts, branding sets, previewing sites, or any DigitalExperience bundle work. Also use when users mention specific content types like sfdc_cms__route, sfdc_cms__themeLayout, etc. or when troubleshooting site deployment. **ALWAYS trigger for ANY guest sharing rule creation/modification, guest user access, sharing records to guest users, or when user provides a guest user ID (format: 005...) - guest sharing rules are EXCLUSIVELY for Experience Cloud sites.**"
Copy link
Copy Markdown
Contributor

@scottmo scottmo Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't use ** here. Description should be plaintext and simple.

guest sharing rules are EXCLUSIVELY for Experience Cloud sites.

I don't think this is necessary? This skill should be scoped to lwr site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants