diff --git a/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/form-controls.md b/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/form-controls.md
index d3c1c44f9..27f0b3f48 100644
--- a/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/form-controls.md
+++ b/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/form-controls.md
@@ -124,20 +124,66 @@ Implements `ControlValueAccessor` and `Validator`. Works with both reactive and
> **Docs:** [Date Range Picker](https://www.infragistics.com/products/ignite-ui-angular/angular/components/date-range-picker)
```typescript
-import { IgxDateRangePickerComponent } from 'igniteui-angular/date-picker';
+import { IgxDateRangePickerComponent, IgxDateRangeStartComponent, IgxDateRangeEndComponent } from 'igniteui-angular/date-picker';
import { IgxDateTimeEditorDirective } from 'igniteui-angular/directives';
import { IGX_INPUT_GROUP_DIRECTIVES } from 'igniteui-angular/input-group';
+import { IgxIconComponent } from 'igniteui-angular/icon';
+import { IgxPickerToggleComponent, IgxPickerClearComponent } from 'igniteui-angular/core';
+```
-// import { IgxDateTimeEditorDirective, IGX_INPUT_GROUP_DIRECTIVES } from '@infragistics/igniteui-angular'; for licensed package
+```html
+
+
+
+
+
+
+
+
```
+
+`IgxDateRangePickerComponent` is imported from `igniteui-angular/date-picker`.
+
+In the two-input configuration:
+
+- place the `input` directly inside `igx-date-range-start` and `igx-date-range-end`
+- use `igx-picker-toggle igxPrefix` for the calendar action
+- use `igx-picker-clear igxSuffix` for the clear action
+
+A plain `igx-prefix` or `igx-suffix` with an `igx-icon` is decorative only and does not trigger picker actions.
+Do not wrap the inputs in an additional `igx-input-group`.
+
+**Avoid these patterns in two-input mode:**
+
+- `calendar_today`
+
+- placing the toggle on only one input unless explicitly requested
+
+Common two-input configuration with calendar toggles:
+
```html
+
+ calendar_today
+
+
+
+ clear
+
+
+
+ calendar_today
+
+
+
+ clear
+
```
@@ -303,6 +349,8 @@ export class MyFormComponent {
- **Always check `app.config.ts` first** — add `provideAnimations()` before using Combo, Select, Date Picker, or any overlay component
- **Import from specific entry points** — avoid the root `igniteui-angular` barrel
- Date/Time pickers implement both `ControlValueAccessor` and `Validator` — they integrate with reactive forms natively
+- For `igx-date-range-picker` with separate start and end inputs, use this structure for both inputs: `igx-picker-toggle igxPrefix`, then `input igxInput igxDateTimeEditor`, then optional `igx-picker-clear igxSuffix`.
+- Do not use a plain `igx-prefix` / `igx-suffix` icon for calendar or clear actions.
## See Also
diff --git a/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/setup.md b/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/setup.md
index 648ff46f5..a8c03016a 100644
--- a/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/setup.md
+++ b/packages/igx-templates/igx-ts/projects/_base/files/__dot__claude/skills/igniteui-angular-components/references/setup.md
@@ -89,8 +89,7 @@ import { IgxComboComponent } from 'igniteui-angular';
| Input Group | `igniteui-angular/input-group` |
| Combo / Simple Combo | `igniteui-angular/combo` |
| Select | `igniteui-angular/select` |
-| Date Picker | `igniteui-angular/date-picker` |
-| Date Range Picker | `igniteui-angular/date-range-picker` |
+| Date Picker / Date Range Picker | `igniteui-angular/date-picker` |
| Time Picker | `igniteui-angular/time-picker` |
| Calendar | `igniteui-angular/calendar` |
| Checkbox | `igniteui-angular/checkbox` |