@salesforce/afv-skills 1.7.5 → 1.9.0

package/skills/fetching-salesforce-docs/scripts/extract_salesforce_doc.py

@@ -0,0 +1,357 @@
+#!/usr/bin/env python3
+"""
+Tiny wrapper for Salesforce documentation extraction.
+
+Behavior:
+- If the URL is on help.salesforce.com, automatically route to the dedicated
+  Help extractor with shadow DOM heuristics.
+- Otherwise, use a lightweight browser-rendered extractor for official
+  Salesforce-owned documentation sites such as developer.salesforce.com,
+  architect.salesforce.com, admin.salesforce.com, lightningdesignsystem.com,
+  and other supported official documentation hosts.
+
+Examples:
+  python3 skills/fetching-salesforce-docs/scripts/extract_salesforce_doc.py \
+    --url "https://help.salesforce.com/s/articleView?id=service.miaw_security.htm&type=5" \
+    --pretty
+
+  python3 skills/fetching-salesforce-docs/scripts/extract_salesforce_doc.py \
+    --url "https://developer.salesforce.com/docs/platform/lwc/guide/use-message-channel-intro.html" \
+    --pretty
+
+  python3 skills/fetching-salesforce-docs/scripts/extract_salesforce_doc.py \
+    --url "https://architect.salesforce.com/well-architected/overview" \
+    --stealth --pretty
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+from typing import Any, Dict
+from urllib.parse import urlparse
+
+from runtime_bootstrap import maybe_reexec_in_sf_docs_runtime
+
+maybe_reexec_in_sf_docs_runtime(__file__)
+
+from playwright.sync_api import TimeoutError as PlaywrightTimeoutError
+from playwright.sync_api import sync_playwright
+
+try:
+    from playwright_stealth import Stealth
+except ImportError:
+    Stealth = None
+
+try:
+    from playwright_stealth import stealth_sync
+except ImportError:
+    stealth_sync = None
+
+from extract_help_salesforce import extract as extract_help_salesforce
+
+
+USER_AGENT = (
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
+    "AppleWebKit/537.36 (KHTML, like Gecko) "
+    "Chrome/122.0.0.0 Safari/537.36"
+)
+
+STRONG_SHELL_TOKENS = [
+    "loading",
+    "sorry to interrupt",
+    "css error",
+    "enable javascript",
+    "we looked high and low",
+    "couldn't find that page",
+    "404 error",
+]
+
+WEAK_SHELL_TOKENS = [
+    "sign in",
+    "cookie preferences",
+]
+
+OFFICIAL_DOC_EXACT_HOSTS = {
+    "salesforce.com",
+    "lightningdesignsystem.com",
+}
+
+OFFICIAL_DOC_SUFFIXES = (
+    ".salesforce.com",
+    ".lightningdesignsystem.com",
+)
+
+
+def normalize_text(text: str) -> str:
+    text = text.replace("\u00a0", " ").replace("\r", "")
+    text = re.sub(r"\n{3,}", "\n\n", text)
+    text = re.sub(r"[ \t]+", " ", text)
+    return text.strip()
+
+
+def looks_like_shell(title: str, text: str) -> bool:
+    haystack = f"{title}\n{text}".lower()
+    if any(token in haystack for token in STRONG_SHELL_TOKENS):
+        return True
+    if any(token in haystack for token in WEAK_SHELL_TOKENS):
+        return len(text.strip()) < 600
+    return False
+
+
+def apply_stealth(page) -> bool:
+    if stealth_sync is not None:
+        try:
+            stealth_sync(page)
+            return True
+        except Exception:
+            pass
+    if Stealth is not None:
+        try:
+            Stealth().apply_stealth_sync(page)
+            return True
+        except Exception:
+            return False
+    return False
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Extract official Salesforce documentation from a URL")
+    parser.add_argument("--url", required=True, help="Official Salesforce doc URL")
+    parser.add_argument("--timeout", type=int, default=60, help="Timeout in seconds (default: 60)")
+    parser.add_argument("--stealth", action="store_true", help="Best-effort stealth mode for bot-sensitive pages")
+    parser.add_argument("--pretty", action="store_true", help="Pretty-print JSON")
+    return parser.parse_args()
+
+
+def is_official_salesforce_host(host: str) -> bool:
+    host = (host or "").lower()
+    return host in OFFICIAL_DOC_EXACT_HOSTS or any(host.endswith(suffix) for suffix in OFFICIAL_DOC_SUFFIXES)
+
+
+def route_kind(url: str) -> str:
+    host = (urlparse(url).hostname or "").lower()
+    if host.endswith("help.salesforce.com"):
+        return "help"
+    if is_official_salesforce_host(host):
+        return "official"
+    raise SystemExit(f"Unsupported host for fetching-salesforce-docs extractor: {host or url}")
+
+
+def extract_official_salesforce_doc(url: str, timeout_seconds: int, use_stealth: bool = False) -> Dict[str, Any]:
+    timeout_ms = timeout_seconds * 1000
+    host = (urlparse(url).hostname or "").lower()
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=True)
+        page = browser.new_page(user_agent=USER_AGENT, viewport={"width": 1440, "height": 1400})
+        stealth_used = apply_stealth(page) if use_stealth else False
+
+        try:
+            response = page.goto(url, wait_until="domcontentloaded", timeout=timeout_ms)
+            http_status = response.status if response else None
+            page.wait_for_timeout(1500)
+            try:
+                page.wait_for_function(
+                    r"""
+                    () => {
+                      const el = document.querySelector('main, article, [role="main"]');
+                      const text = (el?.innerText || el?.textContent || '').trim();
+                      return text.length > 200;
+                    }
+                    """,
+                    timeout=min(timeout_ms, 15000),
+                )
+            except PlaywrightTimeoutError:
+                pass
+            try:
+                page.wait_for_load_state("networkidle", timeout=min(timeout_ms, 15000))
+            except PlaywrightTimeoutError:
+                pass
+            page.wait_for_timeout(500)
+
+            payload = page.evaluate(
+                r"""
+                () => {
+                  function normalize(text) {
+                    return String(text || '')
+                      .replace(/\u00a0/g, ' ')
+                      .replace(/\r/g, '')
+                      .replace(/\n{3,}/g, '\n\n')
+                      .trim();
+                  }
+
+                  function isVisible(el) {
+                    if (!el || !el.getBoundingClientRect) return false;
+                    const rect = el.getBoundingClientRect();
+                    const style = window.getComputedStyle(el);
+                    return rect.width > 0 && rect.height > 0 && style.visibility !== 'hidden' && style.display !== 'none';
+                  }
+
+                  function allRoots() {
+                    const roots = [document];
+                    const queue = [document];
+                    while (queue.length) {
+                      const current = queue.shift();
+                      if (!current || !current.querySelectorAll) continue;
+                      const elements = current.querySelectorAll('*');
+                      for (const el of elements) {
+                        if (el.shadowRoot) {
+                          roots.push(el.shadowRoot);
+                          queue.push(el.shadowRoot);
+                        }
+                      }
+                    }
+                    return roots;
+                  }
+
+                  function deepQueryAll(selector) {
+                    const results = [];
+                    const seen = new Set();
+                    for (const root of allRoots()) {
+                      if (!root.querySelectorAll) continue;
+                      for (const el of root.querySelectorAll(selector)) {
+                        if (!seen.has(el)) {
+                          seen.add(el);
+                          results.push(el);
+                        }
+                      }
+                    }
+                    return results;
+                  }
+
+                  function collectLinks(scope) {
+                    const urls = new Set();
+                    const nodes = scope && scope.querySelectorAll ? scope.querySelectorAll('a[href]') : [];
+                    for (const a of nodes) {
+                      const href = a.href || a.getAttribute('href') || '';
+                      if (!href) continue;
+                      if (href.startsWith('javascript:') || href.startsWith('mailto:')) continue;
+                      urls.add(href);
+                    }
+                    return Array.from(urls);
+                  }
+
+                  const title = document.title || normalize(document.querySelector('title')?.innerText || 'Untitled');
+                  const childLinks = new Set();
+                  for (const root of allRoots()) {
+                    for (const link of collectLinks(root)) childLinks.add(link);
+                  }
+
+                  const selectorConfigs = [
+                    { selector: 'article', strategy: 'article', base: 260 },
+                    { selector: 'main', strategy: 'main', base: 220 },
+                    { selector: '[role="main"]', strategy: 'role-main', base: 220 },
+                    { selector: '.slds-text-longform', strategy: 'longform', base: 200 },
+                    { selector: '.markdown-content', strategy: 'markdown-content', base: 190 },
+                    { selector: '.content-body', strategy: 'content-body', base: 180 },
+                    { selector: '.article-body', strategy: 'article-body', base: 180 },
+                    { selector: '.article-content', strategy: 'article-content', base: 180 },
+                    { selector: '.post-content', strategy: 'post-content', base: 170 },
+                    { selector: '.main-content', strategy: 'main-content', base: 170 },
+                    { selector: '.tds-content', strategy: 'tds-content', base: 165 },
+                    { selector: '.siteforceContentArea .content', strategy: 'siteforce-content', base: 160 },
+                    { selector: 'doc-content-layout', strategy: 'legacy-doc-layout', base: 150 },
+                    { selector: 'doc-xml-content', strategy: 'legacy-doc-xml', base: 145 },
+                    { selector: 'doc-amf-reference .markdown-content', strategy: 'legacy-amf-markdown', base: 150 },
+                    { selector: 'main .content, article .content', strategy: 'nested-content', base: 140 },
+                  ];
+
+                  const candidates = [];
+                  for (const cfg of selectorConfigs) {
+                    const nodes = deepQueryAll(cfg.selector);
+                    for (const node of nodes) {
+                      if (!isVisible(node)) continue;
+                      const text = normalize(node.innerText || node.textContent || '');
+                      if (text.length < 200) continue;
+                      let score = cfg.base + Math.min(text.length, 5000) / 30;
+                      const lowered = text.toLowerCase();
+                      if (lowered.includes(title.toLowerCase())) score += 50;
+                      if (lowered.includes('table of contents')) score -= 80;
+                      if (lowered.includes('cookie preferences')) score -= 120;
+                      if (lowered.includes('sign in')) score -= 120;
+                      candidates.push({
+                        strategy: cfg.strategy,
+                        selector: cfg.selector,
+                        score,
+                        text,
+                        links: collectLinks(node).slice(0, 200),
+                      });
+                    }
+                  }
+
+                  const bodyText = normalize(document.body?.innerText || '');
+                  if (bodyText.length >= 200) {
+                    candidates.push({
+                      strategy: 'body',
+                      selector: 'body',
+                      score: Math.min(bodyText.length, 5000) / 50,
+                      text: bodyText,
+                      links: Array.from(childLinks).slice(0, 200),
+                    });
+                  }
+
+                  candidates.sort((a, b) => b.score - a.score);
+                  const best = candidates[0] || null;
+
+                  return {
+                    url: window.location.href,
+                    title,
+                    strategy: best ? best.strategy : 'none',
+                    selector: best ? best.selector : null,
+                    text: best ? best.text : '',
+                    contentLinks: best ? best.links : [],
+                    childLinks: Array.from(childLinks).slice(0, 200),
+                    candidateCount: candidates.length,
+                  };
+                }
+                """
+            )
+
+            text = normalize_text(payload.get("text", ""))
+            likely_shell = looks_like_shell(payload.get("title", ""), text)
+            ok = bool(text) and len(text) >= 300 and not likely_shell
+
+            return {
+                "ok": ok,
+                "url": payload.get("url", url),
+                "httpStatus": http_status,
+                "title": payload.get("title") or "Untitled",
+                "host": host,
+                "hostKind": "official-salesforce",
+                "strategy": payload.get("strategy"),
+                "selector": payload.get("selector"),
+                "likelyShell": likely_shell,
+                "stealthRequested": use_stealth,
+                "stealthAvailable": stealth_sync is not None or Stealth is not None,
+                "stealthUsed": stealth_used,
+                "text": text,
+                "contentLinks": payload.get("contentLinks", []),
+                "childLinks": payload.get("childLinks", []),
+                "candidateCount": payload.get("candidateCount", 0),
+            }
+        finally:
+            page.close()
+            browser.close()
+
+
+def main() -> int:
+    args = parse_args()
+    kind = route_kind(args.url)
+
+    if kind == "help":
+        result = extract_help_salesforce(args.url, args.timeout, use_stealth=args.stealth)
+        result["routedVia"] = "extract_help_salesforce"
+        result.setdefault("hostKind", "help")
+    else:
+        result = extract_official_salesforce_doc(args.url, args.timeout, use_stealth=args.stealth)
+        result["routedVia"] = "generic_official_salesforce_extractor"
+
+    dump = json.dumps(result, indent=2 if args.pretty else None)
+    print(dump)
+    return 0 if result.get("ok") else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/fetching-salesforce-docs/scripts/runtime_bootstrap.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def sf_docs_runtime_root() -> Path:
+    return Path.home() / ".claude" / ".fetching-salesforce-docs-runtime"
+
+
+def sf_docs_runtime_python() -> Path:
+    root = sf_docs_runtime_root() / "venv"
+    candidates = [
+        root / "bin" / "python",
+        root / "bin" / "python3",
+        root / "Scripts" / "python.exe",
+    ]
+    for candidate in candidates:
+        if candidate.exists():
+            return candidate
+    return candidates[0] if os.name != "nt" else candidates[-1]
+
+
+def prepare_sf_docs_runtime_env(env: dict[str, str] | None = None) -> dict[str, str]:
+    runtime_root = sf_docs_runtime_root()
+    target = dict(env or os.environ)
+    target.setdefault("PLAYWRIGHT_BROWSERS_PATH", str(runtime_root / "ms-playwright"))
+    target.setdefault("SF_DOCS_RUNTIME_ROOT", str(runtime_root))
+    return target
+
+
+def maybe_reexec_in_sf_docs_runtime(script_path: str) -> bool:
+    runtime_python = sf_docs_runtime_python()
+    os.environ.update(prepare_sf_docs_runtime_env())
+
+    if os.environ.get("SF_DOCS_RUNTIME_ACTIVE") == "1":
+        return False
+    if not runtime_python.exists():
+        return False
+
+    try:
+        current_python = Path(sys.executable).resolve()
+        target_python = runtime_python.resolve()
+        if current_python == target_python:
+            os.environ["SF_DOCS_RUNTIME_ACTIVE"] = "1"
+            return False
+    except OSError:
+        pass
+
+    env = prepare_sf_docs_runtime_env()
+    env["SF_DOCS_RUNTIME_ACTIVE"] = "1"
+    os.execve(
+        str(runtime_python),
+        [str(runtime_python), str(Path(script_path).resolve()), *sys.argv[1:]],
+        env,
+    )
+    return True

package/skills/generating-apex/CREDITS.md

@@ -1,30 +1,5 @@
 # Credits & Acknowledgments
 
-This skill was influenced by the [sf-skills](https://github.com/Jaganpro/sf-skills) repository and built upon the collective wisdom of the Salesforce developer community. We gratefully acknowledge the following authors and resources whose ideas, patterns, and best practices have shaped this skill.
+This skill is built on established Salesforce Apex development patterns and the collective knowledge of the Salesforce developer community.
 
 ---
-
-## Authors & Contributors
-
-### Jag Valaiyapathy (**[Jaganpro)](https://github.com/Jaganpro)**
-
-**[sf-skills](https://github.com/Jaganpro/sf-skills)**
-
-Key contributions influencing this skill:
-
-- Pioneering open-source Salesforce skills for agentic coding tools
-- Apex code generation and review patterns
-- Best practices, anti-patterns, and design patterns reference material
-- Template library for common Apex class types
-
-This skill was influenced by the [sf-skills](https://github.com/Jaganpro/sf-skills) repository.
-
----
-
-## Special Thanks
-
-To the entire Salesforce developer community for sharing knowledge, writing blogs, creating open-source tools, and helping each other build better solutions.
-
----
-
-*If we've missed anyone whose work influenced these skills, please let us know so we can add proper attribution.*

package/skills/generating-apex/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-apex
-description: Primary Apex authoring skill for class generation, refactoring, and review. ALWAYS ACTIVATE when the user mentions Apex, .cls, triggers, or asks to create/refactor a class (service, selector, domain, batch, queueable, schedulable, invocable, DTO, utility, interface, abstract, exception, REST resource). Use this skill for requests involving SObject CRUD, mapping collections, fetching related records, scheduled jobs, batch jobs, trigger design, @AuraEnabled controllers, @RestResource endpoints, custom REST APIs, or code review of existing Apex.
+description: "Primary Apex authoring skill for class generation, refactoring, and review. ALWAYS ACTIVATE when the user mentions Apex, .cls, triggers, or asks to create/refactor a class (service, selector, domain, batch, queueable, schedulable, invocable, DTO, utility, interface, abstract, exception, REST resource). Use this skill for requests involving SObject CRUD, mapping collections, fetching related records, scheduled jobs, batch jobs, trigger design, @AuraEnabled controllers, @RestResource endpoints, custom REST APIs, or code review of existing Apex."
+metadata:
+  version: "1.0"
 ---
 
 # Generating Apex
@@ -403,4 +405,4 @@ Deploy: <dry-run or next step>
 
 ## Troubleshooting Boundary
 
-This skill handles production `.cls`/`.trigger`/`.apex` issues only: compile/parse failures, deployment dependency errors, runtime governor-limit failures. For test execution, assertions, coverage, or `sf apex run test` failures, delegate to `generating-apex-test`.
+This skill handles production `.cls`/`.trigger`/`.apex` issues only: compile/parse failures, deployment dependency errors, runtime governor-limit failures. For test execution, assertions, coverage, or `sf apex run test` failures, delegate to `generating-apex-test`.

package/skills/generating-apex-test/CREDITS.md

@@ -1,30 +1,5 @@
 # Credits & Acknowledgments
 
-This skill was influenced by the [sf-skills](https://github.com/Jaganpro/sf-skills) repository and built upon the collective wisdom of the Salesforce developer community. We gratefully acknowledge the following authors and resources whose ideas, patterns, and best practices have shaped this skill.
+This skill is built on established Salesforce Apex development patterns and the collective knowledge of the Salesforce developer community.
 
----
-
-## Authors & Contributors
-
-### Jag Valaiyapathy (**[Jaganpro)](https://github.com/Jaganpro)**
-
-**[sf-skills](https://github.com/Jaganpro/sf-skills)**
-
-Key contributions influencing this skill:
-
-- Pioneering open-source Salesforce skills for agentic coding tools
-- Apex code generation and review patterns
-- Best practices, anti-patterns, and design patterns reference material
-- Template library for common Apex class types
-
-This skill was influenced by the [sf-skills](https://github.com/Jaganpro/sf-skills) repository.
-
----
-
-## Special Thanks
-
-To the entire Salesforce developer community for sharing knowledge, writing blogs, creating open-source tools, and helping each other build better solutions.
-
----
-
-*If we've missed anyone whose work influenced these skills, please let us know so we can add proper attribution.*
+---

package/skills/generating-apex-test/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-apex-test
-description: Generate and validate Apex test classes with TestDataFactory patterns, bulk testing (251+ records), mocking strategies, assertion best practices, and disciplined test-fix loops. Use this skill when creating new Apex test classes, improving test coverage, debugging and fixing failing Apex tests, running test execution and coverage analysis, or implementing testing patterns for triggers, services, controllers, batch jobs, queueables, and integrations. Triggers on *Test.cls, *_Test.cls files, sf apex run test workflows, coverage reports, test-fix loops. Do NOT trigger for production Apex code (use generating-apex) or Jest/LWC tests.
+description: "Generate and validate Apex test classes with TestDataFactory patterns, bulk testing (251+ records), mocking strategies, assertion best practices, and disciplined test-fix loops. Use this skill when creating new Apex test classes, improving test coverage, debugging and fixing failing Apex tests, running test execution and coverage analysis, or implementing testing patterns for triggers, services, controllers, batch jobs, queueables, and integrations. Triggers on *Test.cls, *_Test.cls files, sf apex run test workflows, coverage reports, test-fix loops. Do NOT trigger for production Apex code (use generating-apex) or Jest/LWC tests."
+metadata:
+  version: "1.0"
 ---
 
 # Generating Apex Tests

package/skills/generating-custom-application/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-custom-application
 description: "Use this skill when users need to create or configure Salesforce Custom Applications. Trigger when users mention custom apps, application metadata, app navigation, or organizing tabs into applications. Use when users want to create app containers for tabs and pages. Always use this skill for custom application work."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill

package/skills/generating-custom-field/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-custom-field
 description: "Use this skill when users need to create, generate, or validate Salesforce Custom Field metadata. Trigger when users mention custom fields, field types, Roll-up Summary fields, Master-Detail relationships, Lookup relationships, formula fields, picklists, or field metadata. Also use when users encounter field deployment errors, especially around Roll-up Summary format, Master-Detail constraints, or formula issues. Always use this skill for any custom field metadata work, field generation, or field troubleshooting."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill
@@ -498,4 +500,4 @@ Before generating CustomField XML, verify:
 
 ### Naming Checks
 - [ ] Is the API name free of reserved words (`Order`, `Group`, `Select`, etc.)?
-- [ ] Is the API name unique on this object?
+- [ ] Is the API name unique on this object?

package/skills/generating-custom-lightning-type/SKILL.md

@@ -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."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill

package/skills/generating-custom-object/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-custom-object
 description: "Use this skill when users need to create, generate, or validate Salesforce Custom Object metadata. Trigger when users mention custom objects, creating objects, object metadata, .object files, sharing models, name fields, or validation rules on objects. Also use when users say things like \"create a custom object\", \"generate object metadata\", \"set up an object for...\", or when they're troubleshooting object deployment errors especially around sharing models and Master-Detail relationships. Always use this skill for any custom object metadata work."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill
@@ -235,4 +237,4 @@ Before generating the Custom Object XML, verify:
 ### Architectural Checks
 - [ ] Is `<description>` present with a meaningful summary?
 - [ ] Are `<enableSearch>` and `<enableReports>` set to `true` if user-facing?
-- [ ] Does the filename match the intended API name?
+- [ ] Does the filename match the intended API name?

package/skills/generating-custom-tab/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-custom-tab
 description: "Use this skill when users need to create or configure Salesforce Custom Tabs. Trigger when users mention tabs, navigation tabs, object tabs, web tabs, Visualforce tabs, Lightning component tabs, app page tabs, or tab configuration. Also use when users want to add navigation to custom objects, create tabs for external content, or set up Lightning page tabs. Always use this skill for any custom tab work."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill
@@ -151,4 +153,4 @@ Also forbidden:
 - Follow consistent naming conventions
 - Object tab files MUST only contain `<customObject>true</customObject>` and `<motif>` — nothing else
 - Web tab files MUST only contain: `<customObject>false</customObject>`, `<label>`, `<motif>`, `<url>`, `<urlEncodingKey>`, and optionally `<description>`, `<frameHeight>` — nothing else
-- Never include `<isHidden>`, `<tabVisibility>`, `<type>`, `<mobileReady>`, or empty elements
+- Never include `<isHidden>`, `<tabVisibility>`, `<type>`, `<mobileReady>`, or empty elements

package/skills/generating-flexipage/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-flexipage
 description: "Use this skill when users need to create, generate, modify, or validate Salesforce Lightning pages (FlexiPages). Trigger when users mention RecordPage, AppPage, HomePage, Lightning pages, page layouts, adding components to pages, or page customization. Also use when users say things like 'create a Lightning page', 'add a component to a page', 'customize the record page', 'generate a FlexiPage', or when they're working with FlexiPage XML files and need help with components, regions, or deployment errors. Always use this skill for any FlexiPage-related work, even if they just mention 'page' in the context of Salesforce."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill

package/skills/generating-flow/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-flow
 description: "Generate Salesforce Flows using the MCP tool execute_metadata_action. Use when the user asks to create, build, or generate a flow — including Screen, Autolaunched, Record-Triggered (before/after-save), Scheduled. Also trigger for flow-like requests such as \"when a record is created\", \"trigger daily at\", \"send an email when\", \"update the field when\", \"automate\", \"workflow\", or \"flow XML/metadata\". This is the only skill for Salesforce Flow generation."
+metadata:
+  version: "1.0"
 ---
 
 ## Goal

package/skills/generating-lightning-app/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: generating-lightning-app
-description: Build complete Salesforce Lightning Experience applications from natural language descriptions. Use this skill when a user requests a "complete app", "Lightning app", "business solution", "management system", or describes a scenario requiring multiple interconnected Salesforce components (objects, fields, pages, tabs, security). Orchestrates all required metadata types in proper dependency order to produce a deployable application.
+description: "Build complete Salesforce Lightning Experience applications from natural language descriptions. Use this skill when a user requests a \"complete app\", \"Lightning app\", \"business solution\", \"management system\", or describes a scenario requiring multiple interconnected Salesforce components (objects, fields, pages, tabs, security). Orchestrates all required metadata types in proper dependency order to produce a deployable application."
 metadata:
   version: "1.0"
   related-skills: generating-custom-object, generating-custom-field, generating-custom-tab, generating-flexipage, generating-custom-application, generating-flow, generating-validation-rule, generating-list-view, generating-permission-set

package/skills/generating-list-view/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: generating-list-view
 description: "Use this skill when users need to create, generate, or validate Salesforce List View metadata. Trigger when users mention list views, filtered record lists, creating views, setting up record columns, filtering records by criteria, or ask about list view visibility. Also use when users say things like \"I need a view that shows...\", \"filter records by...\", \"create a list view for...\", or when they're working with ListView XML files and need validation or troubleshooting."
+metadata:
+  version: "1.0"
 ---
 
 ## When to Use This Skill

package/skills/generating-lwc-components/CREDITS.md

@@ -0,0 +1,5 @@
+# Credits & Acknowledgments
+
+This skill is built on official Salesforce LWC platform patterns and established component development practices.
+
+---