nds-add-icon

Register new HGI icons and aliases in the design system.

14|8|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/mazin-musleh/NDS-vanilla --skill nds-add-icon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nds-add-icon
Source: https://github.com/mazin-musleh/NDS-vanilla/tree/main/.claude/skills/nds-add-icon
Command: npx skills add https://github.com/mazin-musleh/NDS-vanilla --skill nds-add-icon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps design teams register and expose new HGI icons in the inline UI-icon set, ensuring consistent naming, tokens, and aliases across the project.

Core Features & Use Cases

  • Registers one --nds-icon-{name} token and one alias (.nds-hgi-{name} by default) for each new icon.
  • Handles the naming variants to cover different styles and types as needed.
  • The script updates token placement in _sass/_icons.scss and provides guidance for verification and usage.
  • The file is hand-editable and supports icon sources from both raw SVGs and Figma references.

Quick Start

Run the add-icon script with the desired name to register a new HGI icon and its alias.

Frequently Asked Questions about nds-add-icon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new SVG icon to a Figma design system and generate its CSS token?▼

To add a new SVG icon to the design system, this Skill processes the icon name and emits a CSS token (`--nds-icon-{name}`) along with an alias (`.nds-hgi-{name}`) in alphabetically sorted order.

How does the UI-icon set registration process handle naming variants and styles?▼

The UI-icon set registration process handles naming variants to cover different styles and types as needed, updating the `_sass/_icons.scss` file while ensuring consistent tokens and aliases across the project.

Can I use raw SVGs and Figma references to register HGI icons?▼

Yes, you can register HGI icons using sources from both raw SVGs and Figma references. The script processes these inputs and updates the inline UI-icon set with the appropriate CSS tokens.

What is the best way to update design-system tokens for inline UI icons?▼

The best way to update design-system tokens is running the add-icon script, which registers new HGI icons and emits CSS tokens and aliases in alphabetically sorted order within the `_sass/_icons.scss` file.

Do I need to manually edit the _sass/_icons.scss file after adding an HGI icon?▼

No, the script automatically updates token placement in `_sass/_icons.scss` and provides guidance for verification and usage, although the file remains hand-editable for manual adjustments if needed.

When should I use the add-icon script during a design-system update?▼

You should use the add-icon script when expanding the inline UI-icon set across components, themes, and documentation during design-system updates to ensure consistent naming and token generation.