diff --git a/skills/salesforce-flexipage/SKILL.md b/skills/salesforce-flexipage/SKILL.md
index ab13965..f6ef9d2 100644
--- a/skills/salesforce-flexipage/SKILL.md
+++ b/skills/salesforce-flexipage/SKILL.md
@@ -188,7 +188,7 @@ npm install -g @salesforce/cli@latest
### Step 2: Deploy Base Page
```bash
-sf project deploy start --source-dir force-app/main/default/flexipages
+sf project deploy start --dry-run --source-dir force-app/main/default/flexipages
```
**Deploy early, deploy often.** Start with the bootstrapped page, validate it works, then enhance.
diff --git a/skills/salesforce-flexipage/docs/components/flexipage-fieldSection.md b/skills/salesforce-flexipage/docs/components/flexipage-fieldSection.md
index 8f81a53..d416e69 100644
--- a/skills/salesforce-flexipage/docs/components/flexipage-fieldSection.md
+++ b/skills/salesforce-flexipage/docs/components/flexipage-fieldSection.md
@@ -1,4 +1,4 @@
-# fieldSection
+# flexipage:fieldSection
**Use for:** Displaying fields in columns.
@@ -7,10 +7,108 @@
2. Column Facets (Facet type)
3. Field Facets (Facet type)
+**Critical:** the `columns` property must match the name of the facet where the columns are defined. It is *not* a number.
+
**Referenced in component property:**
```xml
-
- columns
- Facet-{uuid}
-
+
+
+
+
+
+ uiBehavior
+ required
+
+ Record.Field0
+ RecordColumn1Field0
+
+
+
+
+
+ uiBehavior
+ none
+
+ Record.Field1
+ RecordColumn1Field1
+
+
+
+ Facet-FieldSection-Column1
+ Facet
+
+
+
+
+
+
+ uiBehavior
+ none
+
+ Record.Field2
+ RecordColumn2Field0
+
+
+
+
+
+ uiBehavior
+ none
+
+ Record.Type
+ RecordColumn2Field1
+
+
+
+ Facet-FieldSection-Column2
+ Facet
+
+
+
+
+
+
+ body
+ Facet-FieldSection-Column1
+
+ flexipage:column
+ flexipage_column1
+
+
+
+
+
+ body
+ Facet-FieldSection-Column2
+
+ flexipage:column
+ flexipage_column2
+
+
+ Facet-FieldSection-Columns
+ Facet
+
+
+
+
+
+
+ columns
+ Facet-FieldSection-Columns
+
+
+ horizontalAlignment
+ false
+
+
+ label
+ Information
+
+ flexipage:fieldSection
+ flexipage_fieldSection
+
+
+ main
+ Region
+
```
diff --git a/skills/salesforce-flexipage/docs/components/flexipage-richText.md b/skills/salesforce-flexipage/docs/components/flexipage-richText.md
index f9ef013..323119a 100644
--- a/skills/salesforce-flexipage/docs/components/flexipage-richText.md
+++ b/skills/salesforce-flexipage/docs/components/flexipage-richText.md
@@ -1,4 +1,4 @@
-# Rich Text Component
+# flexipage:richText (Rich Text Component)
**Component name:** `flexipage:richText`
@@ -17,10 +17,12 @@
decorate
true
+
+ richTextValue
+ {encoded text goes here}
+
flexipage:richText
- flexipage_richText
+ flexipage_richText_{uuid}
```
-
-**Identifier Pattern:** `flexipage_richText` or `flexipage_richText_{sequence}`
diff --git a/skills/salesforce-flexipage/docs/components/record_flexipage-dynamicHighlights.md b/skills/salesforce-flexipage/docs/components/record_flexipage-dynamicHighlights.md
index 9e01395..80869bf 100644
--- a/skills/salesforce-flexipage/docs/components/record_flexipage-dynamicHighlights.md
+++ b/skills/salesforce-flexipage/docs/components/record_flexipage-dynamicHighlights.md
@@ -1,12 +1,79 @@
-# dynamicHighlights (RecordPage Header)
+# record_flexipage:dynamicHighlights (RecordPage Header)
+
+**Use for:** Displaying key record information and actions prominently. This component is particularly useful for providing a quick and configurable overview of record details.
**Location:** Must be in `header` region.
-**Explicit Fields** (via CLI): Use the most important fields to show a summary of the record. The single primary field is used to identify the record, like a name. The secondary fields (max 12, recommended 6) are used as a summary of the record.
+**Explicit Fields:** Use the most important fields to show a summary of the record. The single primary field is used to identify the record, like a name. The secondary fields (max 12, recommended 6) are used as a summary of the record.
-```bash
---primary-field Name
---secondary-fields Phone,Industry,AnnualRevenue
+**Structure:** Requires three flexiPageRegions: one template region (Region type) that contains the component and two facets (one for the primary field and one for the secondary fields) that are referenced by the component.
+
+```xml
+
+
+
+
+ uiBehavior
+ none
+
+ Record.Name
+ RecordNamePrimaryField
+
+
+ Facet-PrimaryFields
+ Facet
+
+
+
+
+
+
+ uiBehavior
+ none
+
+ Record.Phone
+ RecordPhoneSecondaryField0
+
+
+
+
+ ...
+
+
+ Facet-SecondaryFields
+ Facet
+
+
+
+
+
+ actionNames
+
+
+ Edit
+
+
+ Delete
+
+
+
+
+ numVisibleActions
+ 3
+
+
+ primaryField
+ Facet-PrimaryFields
+
+
+ secondaryFields
+ Facet-SecondaryFields
+
+ record_flexipage:dynamicHighlights
+ record_flexipage_dynamicHighlights
+
+
+ header
+ Region
+
```
-
-CLI generates Facets with field references automatically.