Skip to main content

Starwind UI v3.0 is now available! Migration guide

On this page

Skills

View Markdown

Starwind Skills give AI assistants project-aware guidance for Starwind UI v3. Compatible agents can select the right Starwind layer, follow Astro or React conventions, migrate older projects, update components safely, customize Tailwind CSS v4 themes, and work with Starwind Pro blocks.

The public skills live in starwind-ui/skills.

For example, you can ask your AI assistant to:

  • “Build an accessible Astro account settings form with validation, notification switches, and a busy Save button.”
  • “Create a React edit-profile dialog with an avatar and searchable Starwind Combobox.”
  • “Rebrand this project with semantic colors for light and dark modes while preserving the existing theme.”
  • “Adapt this installed Pro hero block for my product while preserving its responsive, dark-mode, and motion behavior.”

Install

The installer discovers the starwind-ui and starwind-pro skills from GitHub. It then lets you select the target agents and installation scope. Learn more about skills at skills.sh.

Update

Update both installed skills when Starwind publishes new guidance:

Choose a Layer

LayerChoose it when
Styled componentYou want the default, complete component installed with starwind add.
PrimitiveYou need lower-level anatomy from a package or vendored source.
RuntimeYou need raw DOM behavior or are building a custom framework adapter.

What’s Included

Starwind UI

The starwind-ui skill applies to Starwind UI v3 projects that use Astro or React. It covers styled components, Primitive packages or vendored Primitive source, direct Runtime integrations, Tailwind CSS v4, starwind.config.json, migrations, updates, theme tokens, dark mode, and composition.

It guides agents to:

  • Prefer npx starwind@latest init, npx starwind@latest add, and other documented Starwind CLI commands.
  • Read current Starwind docs through docs URLs, Markdown pages, llms-full.txt, the CLI, or MCP when available.
  • Compose existing Starwind components instead of injecting raw copied HTML.
  • Preview component updates and preserve project customizations.

Starwind Pro

The starwind-pro skill applies when an agent is discovering, installing, or adapting Starwind Pro blocks.

It guides agents to:

  • Distinguish free blocks from premium blocks that require Starwind Pro access.
  • Check V3 access and starwind.config.json before installing premium blocks.
  • Use the exact block install command returned by current search results.
  • Preserve responsive behavior, accessibility, and theme integration while adapting blocks.

How It Works

  1. The skill activates when an agent is working in a Starwind UI or Starwind Pro context.
  2. The agent reads the local project shape, including package.json, framework config, starwind.config.json, installed components, theme CSS, and import aliases.
  3. The agent uses current Starwind context from docs, Markdown pages, llms-full.txt, the CLI, or the MCP server before generating code.
  4. The agent follows current framework and component APIs. Astro uses class and for. React uses className and htmlFor. The agent can install Combobox for searchable selection and preview updates before it changes customized files.

Skills And MCP

Skills and MCP solve different parts of the workflow:

SurfaceUse it for
SkillsPersistent agent behavior, Starwind-specific rules, and project editing guidance.
MCP ServerCurrent lookup data and validated commands for components, docs, migrations, and Pro blocks.
Markdown docsFocused page-level context by appending .md to the docs path.
llms.txtCompact discovery and links to current AI surfaces.
ai-manifest.jsonStructured inventory, framework availability, Skills, and MCP metadata.
llms-full.txtFull static docs context when an agent cannot call MCP tools.

Use both Skills and MCP when your agent supports them. Skills teach the agent how to edit a project. MCP returns current Starwind data and commands for the agent to review.