Skip to content

Commit e277862

Browse files
authored
Merge pull request #167 from IgniteUI/ibarakov/skills-refactor
feat(skills): refactor react skills
2 parents bd65412 + 65b9860 commit e277862

9 files changed

Lines changed: 87 additions & 284 deletions

File tree

skills/igniteui-react-components/SKILL.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,6 @@ user-invocable: true
3535
| Charts | `igniteui-react-charts` (trial) `@infragistics/igniteui-react-charts` (licensed) | `igniteui-react-charts` |
3636
| Gauges | `igniteui-react-gauges` (trial) `@infragistics/igniteui-react-gauges` (licensed) | `igniteui-react-gauges` |
3737
| Maps | `igniteui-react-maps` (trial) `@infragistics/igniteui-react-maps` (licensed) | `igniteui-react-maps` |
38-
3938
## Example Usage
4039

4140
- "What component should I use to display a list of items with actions?"
@@ -179,10 +178,3 @@ Use [COMPONENT-CATALOGUE.md](./reference/COMPONENT-CATALOGUE.md) to map any UI n
179178
6. **Handle events as `CustomEvent`** — not `React.SyntheticEvent`
180179
7. **Use refs sparingly** — prefer declarative props
181180
8. **Check slot names** in the docs
182-
183-
## Additional Resources
184-
185-
- [Ignite UI for React — Getting Started](https://www.infragistics.com/products/ignite-ui-react/react/components/general-getting-started)
186-
- [React Examples Repository](https://github.com/IgniteUI/igniteui-react-examples)
187-
- [npm: igniteui-react](https://www.npmjs.com/package/igniteui-react)
188-
- [@lit/react Documentation](https://lit.dev/docs/frameworks/react/)

skills/igniteui-react-components/reference/CHARTS-GRIDS.md

Lines changed: 6 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,10 @@ IgrCategoryChartModule.register();
5353

5454
## Complete Chart Example
5555

56+
> Call `get_doc('react', 'column-chart')` for full `IgrCategoryChart` and `IgrDataChart` usage, prop tables, and code examples. Call `get_doc('react', 'chart-features')` for axes, annotations, animations, markers, and tooltips.
57+
58+
The minimum pattern — register the module at file scope, then wrap the component in a sized container:
59+
5660
```tsx
5761
import { IgrCategoryChart, IgrCategoryChartModule } from 'igniteui-react-charts';
5862
import styles from './dashboard-view.module.css';
@@ -80,20 +84,6 @@ export default function DashboardView() {
8084
}
8185
```
8286

83-
```css
84-
/* dashboard-view.module.css */
85-
.chart-container {
86-
min-width: 400px;
87-
min-height: 300px;
88-
flex-grow: 1;
89-
flex-basis: 0;
90-
}
91-
.chart-container > * {
92-
height: 100%;
93-
width: 100%;
94-
}
95-
```
96-
9787
## Complete Data Chart Example
9888

9989
> **⚠️ IMPORTANT:** `IgrDataChart` requires registering **multiple modules** depending on the series type used. For bar charts, register the modules shown below. If you miss any module, the chart or axis types will silently fail to render.
@@ -140,6 +130,8 @@ IgrDataChartAnnotationModule.register();
140130

141131
> **Bar charts are horizontal** — categories go on the Y-axis and numeric values on the X-axis. This is the opposite of column charts.
142132
133+
> For the full `IgrDataChart` API (all series types, axis options, layers), call `get_doc('react', 'bar-chart')` or `get_doc('react', 'column-chart')`.
134+
143135
### Complete Bar Chart Component (Multiple Series)
144136

145137
```tsx
@@ -288,28 +280,6 @@ export default function BarChartView() {
288280
}
289281
```
290282

291-
### Key Props Reference for `IgrBarSeries`
292-
293-
| Prop | Type | Description |
294-
|---|---|---|
295-
| `name` | `string` | Unique identifier — **required** when referencing the series from other elements |
296-
| `xAxisName` | `string` | Must match the `name` of an `IgrNumericXAxis` declared in the same chart |
297-
| `yAxisName` | `string` | Must match the `name` of an `IgrCategoryYAxis` declared in the same chart |
298-
| `valueMemberPath` | `string` | Field name in the data object that holds the bar length value |
299-
| `dataSource` | `any[]` | The data array — can differ per series for independent datasets |
300-
| `title` | `string` | Series label shown in the legend |
301-
| `isTransitionInEnabled` | `boolean` | Animates bars on initial render |
302-
| `isHighlightingEnabled` | `boolean` | Dims other series when one is hovered |
303-
| `showDefaultTooltip` | `boolean` | Shows a simple built-in tooltip (use `IgrDataToolTipLayer` for richer output) |
304-
305-
### Available Bar Chart Variants
306-
307-
| Variant | Component | Module |
308-
|---|---|---|
309-
| Bar (horizontal) | `IgrBarSeries` | `IgrDataChartVerticalCategoryModule` |
310-
| Stacked Bar | `IgrStackedBarSeries` + `IgrStackedFragmentSeries` | `IgrDataChartStackedModule` |
311-
| Stacked 100% Bar | `IgrStacked100BarSeries` + `IgrStackedFragmentSeries` | `IgrDataChartStackedModule` |
312-
313283
## Complete Grid Lite Example
314284

315285
> **⚠️ IMPORTANT:** Grid Lite (`IgrGridLite` from `igniteui-react/grid-lite`) requires installing both `igniteui-react` and `igniteui-grid-lite` packages. It's a React wrapper component (uses `Igr` prefix) and works like any standard React component — no `.register()` needed.

skills/igniteui-react-components/reference/COMPONENT-CATALOGUE.md

Lines changed: 8 additions & 142 deletions
Large diffs are not rendered by default.

skills/igniteui-react-components/reference/EVENT-HANDLING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ function MyForm() {
3535

3636
## Common Event Props
3737

38+
> For component-specific event signatures and detail types, call `get_api_reference('react', '<Component>', 'events')` — e.g. `get_api_reference('react', 'IgrCombo', 'events')`.
39+
3840
| Component | Event Prop | Fires When |
3941
|---|---|---|
4042
| `IgrButton` | `onClick` | Button is clicked |

skills/igniteui-react-customize-theme/SKILL.md

Lines changed: 7 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -106,14 +106,14 @@ import './index.css'; // Overrides second
106106

107107
## Theming Architecture
108108

109-
The Ignite UI theming system is built on four pillars:
109+
The Ignite UI theming system is built on **palette**, **typography**, **elevations**, and per-component **schemas**. Use the MCP theming tools at the right stage:
110110

111-
| Concept | Purpose |
112-
|---|---|
113-
| **Palette** | Color system with primary, secondary, surface, gray, info, success, warn, error families |
114-
| **Typography** | Font family, type scale (h1–h6, subtitle, body, button, caption, overline) |
115-
| **Elevations** | Box-shadow levels 0–24 for visual depth |
116-
| **Schema** | Per-component recipes mapping palette colors to component tokens |
111+
- **`create_palette`** — when the user provides brand colors; generates luminance-safe shades for all palette roles
112+
- **`create_theme`** — generates the complete global theme CSS; call after `create_palette`
113+
- **`create_typography`** — when the user wants to change fonts, type scale, or weights
114+
- **`create_elevations`** — when the user wants to adjust shadow depth
115+
- **`get_component_design_tokens`** - before writing any component-level CSS; retrieves the current token names for a specific component
116+
- **`set_size`**, **`set_spacing`**, or **`set_roundness`** - adjust component size, content spacing, and roundness.
117117

118118
### Design Systems
119119

@@ -182,10 +182,3 @@ See [CSS-THEMING.md](./reference/CSS-THEMING.md) for approaches: class toggle, m
182182
4. **Palette shades**: 50 = lightest, 900 = darkest
183183
5. **Surface color must match variant** — light color for `light`, dark for `dark`
184184
6. **Never hardcode colors after palette generation**
185-
186-
## Additional Resources
187-
188-
- [Ignite UI for React — Themes Overview](https://www.infragistics.com/products/ignite-ui-react/react/components/themes/overview)
189-
- [igniteui-theming npm package](https://www.npmjs.com/package/igniteui-theming)
190-
- [CSS Custom Properties on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties)
191-
- [CSS ::part() on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/::part)

skills/igniteui-react-customize-theme/reference/CSS-THEMING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,8 @@ For truly dynamic one-off overrides:
148148

149149
Override individual component appearance using CSS custom properties.
150150

151+
> **AGENT INSTRUCTION**: Before writing component-level token overrides, call `get_component_design_tokens` with the component name (e.g., `"avatar"`, `"button"`, `"grid"`) to retrieve the current, correct token names. Token names vary by component and can change between versions. Use only tokens returned by that call — do not guess or reuse tokens from other components.
152+
151153
```css
152154
/* Target the Ignite UI web component tag name */
153155
igc-avatar {

skills/igniteui-react-customize-theme/reference/MCP-SERVER.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -62,14 +62,6 @@ Edit the Claude Desktop config file:
6262
3. Set Command to `npx` and Arguments to `igniteui-theming igniteui-theming-mcp`
6363
4. Click OK and restart the AI Assistant
6464

65-
## MCP Server Workflow
66-
67-
1. **Detect platform**: Call `detect_platform` — it will detect `webcomponents` from `package.json`
68-
2. **Generate a theme**: Call `create_theme` with your desired colors and design system
69-
3. **Customize components**: Call `get_component_design_tokens` first, then `create_component_theme` with palette token values
70-
4. **Get color references**: Call `get_color` to get the correct CSS custom property for any palette shade
71-
5. **Adjust layout**: Call `set_size`, `set_spacing`, or `set_roundness`
72-
7365
## File Safety Rule
7466

7567
> **IMPORTANT — File Safety Rule**: When generating theme code, **never overwrite existing style files directly**. Always propose changes as an update and let the user review before writing to disk.

skills/igniteui-react-generate-from-image-design/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ After the table, translate the image into CSS Grid rows and columns first. Prese
6565

6666
This skill is React-only. Check package routing, theme CSS imports, or licensing only when imports, packages, or theming depend on it.
6767

68-
Then call `list_components` with `framework: "react"` and relevant filters to find components matching each UI pattern. Common filters:
68+
Then call `list_components('react')` and relevant filters to find components matching each UI pattern. Common filters:
6969

7070
- `chart`, `sparkline` - for data visualization
7171
- `list view`, `card`, `avatar`, `badge` - for data display
@@ -80,7 +80,7 @@ For component-to-Ignite-UI mapping, see [reference/component-mapping.md](referen
8080

8181
## Step 4: Look Up Component API
8282

83-
For every chosen component category, call `get_doc` with the doc name from `list_components` results (e.g., `name: "card"`, `framework: "react"`). Use the doc `name` field from the MCP results, not the result title shown in the list. This is mandatory before coding and gives exact React usage patterns, prop names, slot structure, event signatures, and any required module registration.
83+
For every chosen component category, call `get_doc('react', '<name>')` using the doc `name` field from `list_components` results (e.g., `get_doc('react', 'card')`), not the result title shown in the list. This is mandatory before coding and gives exact React usage patterns, prop names, slot structure, event signatures, and any required module registration.
8484

8585
Call `search_docs` for feature-based questions (e.g., "how to configure [component] for [specific behavior or styling need]").
8686

skills/igniteui-react-generate-from-image-design/reference/component-mapping.md

Lines changed: 60 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -11,51 +11,37 @@
1111
- [Package Requirements](#package-requirements)
1212
- [Import Patterns](#import-patterns)
1313

14+
> **For component API details** (props, events, slots, examples), call `get_doc` with `'react'` and the doc name from `list_components` results. Use `search_api` for specific property lookup.
15+
1416
## Dashboard & Layout Components
1517

16-
| UI Pattern | Ignite UI Component | Key Properties |
17-
|---|---|---|
18-
| Top navigation bar | `IgrNavbar` | children plus named action/content slots |
19-
| Side navigation | `IgrNavDrawer` | `open`, drawer items, `icon` and `content` slots |
20-
| Content cards/panels | `IgrCard` | `IgrCardHeader`, `IgrCardContent`, `IgrCardActions` |
21-
| Tabbed content | `IgrTabs` + `IgrTab` | `label`, `slot="label"` |
22-
| Accordion sections | `IgrAccordion` | `IgrExpansionPanel` children |
23-
| Split layouts | `IgrSplitter` | resizable panes when splitter chrome is visible |
24-
| Tile dashboard | `IgrTileManager` | drag/resize tiles |
18+
| UI Pattern | Ignite UI Component |
19+
|---|---|
20+
| Top navigation bar | `IgrNavbar` |
21+
| Side navigation | `IgrNavDrawer` |
22+
| Content cards/panels | `IgrCard` |
23+
| Tabbed content | `IgrTabs` + `IgrTab` |
24+
| Accordion sections | `IgrAccordion` |
25+
| Split layouts | `IgrSplitter` |
26+
| Tile dashboard | `IgrTileManager` |
2527

2628
Decision rule:
2729

2830
- Use `IgrNavbar` for a top horizontal bar when its slot structure and behavior match the screenshot. Use custom children and CSS flex overrides to achieve multi-zone layouts inside it. Use a plain `<header>` when that is a closer structural fit.
2931
- Use `IgrNavDrawer` for a sidebar or side-navigation panel when drawer structure and behavior match the screenshot. Configure open and mini behavior according to whether the design shows fixed, collapsible, or icon-only navigation. Use a plain `<aside>` when a static custom sidebar matches the screenshot better.
3032
- Use `IgrTabs` for a horizontal tab strip when the screenshot clearly shows tabbed state switching. Use label-only tabs for routed navigation and inline tab content for local view switching.
3133

32-
Component decision matrix (by visual pattern, domain-neutral):
33-
34-
| Visual Pattern | Recommended Component | Notes |
35-
|---|---|---|
36-
| Repeated rows with icon/text/action | `IgrList` | Use when the row anatomy and interaction model match. Compose the row content with React children and the documented slots. Use native `<ul>/<li>` or custom containers when that is a closer visual fit |
37-
| Spreadsheet-like editable or sortable table | `IgrGridLite` or `IgrGrid` | Use only when content is truly tabular. Prefer `IgrGridLite` for lightweight MIT cases and `IgrGrid` when advanced grid features are required |
38-
| Hierarchical or tree-structured table | `IgrTreeGrid` or `IgrTree` | Use `IgrTreeGrid` for hierarchical tables and `IgrTree` for tree-style navigation or nested lists |
39-
| Content blocks / summary cards | `IgrCard` | Use when card chrome helps match the panel shape and structure. Use `IgrCardHeader`, `IgrCardContent`, and `IgrCardActions`, or plain `<div>` containers for flat or highly custom tiles |
40-
| Any text input field | `IgrInput` | Use when the input anatomy matches the screenshot, including search fields and inline editors. Apply CSS to match the screenshot's border/radius style |
41-
| Dropdown or select | `IgrSelect` | Use when the screenshot clearly shows select/dropdown behavior |
42-
| Form fields with labels and inputs | `IgrInput`, `IgrSelect`, `IgrCombo`, `IgrDatePicker`, `IgrDateTimeInput` | Cover text, select, combo, and date/time inputs |
43-
| Multi-step form / wizard | `IgrStepper` | Use when a sequence of steps is visually present |
44-
| Filter chips / tag inputs | `IgrChip` | Use when chip anatomy matches status badges, filter tags, or removable labels in the screenshot |
45-
| Calendar or date picker as a primary view element | `IgrCalendar`, `IgrDatePicker`, `IgrDateRangePicker` | Use when scheduling or date selection is the core UI |
46-
| Top icon/action bar | `IgrNavbar` with `IgrButton` / `IgrIconButton` | Use when a navbar structure matches the screenshot; use plain icon buttons or custom containers when that is a closer fit |
47-
4834
## Chart Components
4935

50-
| UI Pattern | Ignite UI Component | Key Properties |
51-
|---|---|---|
52-
| Area chart | `IgrCategoryChart` | `chartType`, `markerTypes`, `areaFillOpacity` |
53-
| Line chart | `IgrCategoryChart` | `chartType`, `markerTypes` |
54-
| Column chart | `IgrCategoryChart` | `chartType`, `markerTypes`, `includedProperties` |
55-
| Sparkline (mini chart) | `IgrSparkline` or `IgrDataChart` | `displayType`, `valueMemberPath`, sized container |
56-
| Pie/donut chart | `IgrPieChart` | `valueMemberPath`, `labelMemberPath` |
57-
| Financial chart | `IgrFinancialChart` | OHLC/candlestick data |
58-
| Complex multi-series | `IgrDataChart` | multiple series + axes plus module registration |
36+
| UI Pattern | Ignite UI Component |
37+
|---|---|
38+
| Area chart | `IgrCategoryChart` |
39+
| Line chart | `IgrCategoryChart` |
40+
| Column chart | `IgrCategoryChart` |
41+
| Sparkline (mini chart) | `IgrSparkline` or `IgrDataChart` |
42+
| Pie/donut chart | `IgrPieChart` |
43+
| Financial chart | `IgrFinancialChart` |
44+
| Complex multi-series | `IgrDataChart` |
5945

6046
Decision rule:
6147

@@ -65,17 +51,17 @@ Decision rule:
6551

6652
## Data Display Components
6753

68-
| UI Pattern | Ignite UI Component | Key Properties |
69-
|---|---|---|
70-
| Item list | `IgrList` | slot-based row content, selection, and dense list styling |
71-
| User avatar | `IgrAvatar` | `initials`, `shape`, `src` |
72-
| Status badge | `IgrBadge` | value/children plus token-based styling |
73-
| Icons | `IgrIcon` | icon name, collection, styling |
74-
| Progress bar | `IgrLinearProgress` | `value`, `max` |
75-
| Circular progress | `IgrCircularProgress` | `value`, `max` |
76-
| Flat data grid | `IgrGridLite` or `IgrGrid` | choose by feature level and package availability |
77-
| Hierarchical/tree data grid | `IgrTreeGrid` | parent-child data |
78-
| Filter/tag chips | `IgrChip` | selected state, removable UI, token-based styling |
54+
| UI Pattern | Ignite UI Component |
55+
|---|---|
56+
| Item list | `IgrList` |
57+
| User avatar | `IgrAvatar` |
58+
| Status badge | `IgrBadge` |
59+
| Icons | `IgrIcon` |
60+
| Progress bar | `IgrLinearProgress` |
61+
| Circular progress | `IgrCircularProgress` |
62+
| Flat data grid | `IgrGridLite` or `IgrGrid` |
63+
| Hierarchical/tree data grid | `IgrTreeGrid` |
64+
| Filter/tag chips | `IgrChip` |
7965

8066
Decision rule:
8167

@@ -86,44 +72,44 @@ Decision rule:
8672

8773
## Form & Input Components
8874

89-
| UI Pattern | Ignite UI Component | Key Properties |
90-
|---|---|---|
91-
| Text input | `IgrInput` | `label`, `placeholder`, `type` |
92-
| Dropdown select | `IgrSelect` | option children, label, value |
93-
| Searchable multi-select | `IgrCombo` | `data`, `displayKey`, `valueKey` |
94-
| Date picker | `IgrDatePicker` | value and label props |
95-
| Date/time input | `IgrDateTimeInput` | value, format options |
96-
| Toggle switch | `IgrSwitch` | checked state, change events |
97-
| Checkbox | `IgrCheckbox` | checked state, `indeterminate` |
98-
| Radio button group | `IgrRadioGroup` + `IgrRadio` | `name`, selected value |
99-
| Slider | `IgrSlider` | `min`, `max`, `value` |
100-
| Multi-step wizard | `IgrStepper` | orientation, step composition |
101-
| Chip filter bar | `IgrChip` collection in a flex wrapper | compose removable/filter chips manually |
75+
| UI Pattern | Ignite UI Component |
76+
|---|---|
77+
| Text input | `IgrInput` |
78+
| Dropdown select | `IgrSelect` |
79+
| Searchable multi-select | `IgrCombo` |
80+
| Date picker | `IgrDatePicker` |
81+
| Date/time input | `IgrDateTimeInput` |
82+
| Toggle switch | `IgrSwitch` |
83+
| Checkbox | `IgrCheckbox` |
84+
| Radio button group | `IgrRadioGroup` + `IgrRadio` |
85+
| Slider | `IgrSlider` |
86+
| Multi-step wizard | `IgrStepper` |
87+
| Chip filter bar | `IgrChip` collection in a flex wrapper |
10288

10389
## Calendar & Scheduling Components
10490

105-
| UI Pattern | Ignite UI Component | Key Properties |
106-
|---|---|---|
107-
| Calendar view | `IgrCalendar` | selection mode, `value`, change events |
108-
| Date range picker | `IgrDateRangePicker` | range value, change events |
109-
| Month/year picker | `IgrCalendar` | month/year view settings per docs |
91+
| UI Pattern | Ignite UI Component |
92+
|---|---|
93+
| Calendar view | `IgrCalendar` |
94+
| Date range picker | `IgrDateRangePicker` |
95+
| Month/year picker | `IgrCalendar` |
11096

11197
## Map Components
11298

113-
| UI Pattern | Ignite UI Component | Key Properties |
114-
|---|---|---|
115-
| World map | `IgrGeographicMap` | `zoomable`, `backgroundContent` |
116-
| Map markers | `IgrGeographicSymbolSeries` | `latitudeMemberPath`, `longitudeMemberPath`, `markerType`, `markerBrush` |
117-
| Bubble overlay | `IgrGeographicProportionalSymbolSeries` | sized markers |
118-
| Shape regions | `IgrGeographicShapeSeries` | polygon rendering |
99+
| UI Pattern | Ignite UI Component |
100+
|---|---|
101+
| World map | `IgrGeographicMap` |
102+
| Map markers | `IgrGeographicSymbolSeries` |
103+
| Bubble overlay | `IgrGeographicProportionalSymbolSeries` |
104+
| Shape regions | `IgrGeographicShapeSeries` |
119105

120106
## Gauge Components
121107

122-
| UI Pattern | Ignite UI Component | Key Properties |
123-
|---|---|---|
124-
| Linear gauge | `IgrLinearGauge` | `value`, `minimumValue`, `maximumValue`, `needleBrush` |
125-
| Radial gauge | `IgrRadialGauge` | `value`, `minimumValue`, `maximumValue` |
126-
| Bullet graph | `IgrBulletGraph` | performance vs target |
108+
| UI Pattern | Ignite UI Component |
109+
|---|---|
110+
| Linear gauge | `IgrLinearGauge` |
111+
| Radial gauge | `IgrRadialGauge` |
112+
| Bullet graph | `IgrBulletGraph` |
127113

128114
## Package Requirements
129115

0 commit comments

Comments
 (0)