Skip to content

@W-21749060 fix: update first time site creation instructions#117

Open
fcwong wants to merge 4 commits intoforcedotcom:mainfrom
fcwong:first-site-creation
Open

@W-21749060 fix: update first time site creation instructions#117
fcwong wants to merge 4 commits intoforcedotcom:mainfrom
fcwong:first-site-creation

Conversation

@fcwong
Copy link
Copy Markdown

@fcwong fcwong commented Mar 26, 2026

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

What changed

Enhanced instructions for first time site creation (if user chooses Option 1 for bootstrap new LWR Site). The flow includes:

  1. Call sf cli to create the site
  2. Ask user if they want to poll and wait for retrieval OR retrieve themselves

@W-21749060@

Why

Makes the instruction more 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)


Use the MCP tool `run_soql_query` to run this query on the given target org. Repeat until `Status` is `Complete`.

Once complete, run each of the following retrieval commands **one at a time**. Do not chain them together (e.g. do not use `&&`). Wait for each command to return output before running the next:
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I found that breaking up the command worked best and didn't have the chat hang/stuck on pending

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants