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.