On this page

Skills

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

pnpm dlx skills@latest add starwind-ui/skills

npx skills@latest add starwind-ui/skills

yarn dlx skills@latest add starwind-ui/skills

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:

pnpm dlx skills@latest update starwind-ui starwind-pro

npx skills@latest update starwind-ui starwind-pro

yarn dlx skills@latest update starwind-ui starwind-pro

Example Prompts

“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.”

What’s Included

Starwind UI

The starwind-ui skill covers Astro and React projects, styled components, Primitive adapters, Runtime integrations, Tailwind CSS v4 themes, migrations, and component updates.

It guides agents to:

Use the documented Starwind CLI commands.
Read current component and framework documentation before editing a project.
Compose installed Starwind components and preserve project customizations.
Choose Styled Components, Primitive adapters, or Runtime APIs based on the requested level of control.

Starwind Pro

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

It helps agents:

Distinguish free blocks from premium blocks that require Pro access.
Check project authorization before installing premium blocks.
Use the install command returned by the current catalog.
Preserve responsive behavior, accessibility, and theme integration while adapting blocks.

Skills And MCP

Skills and MCP solve different parts of the workflow:

Surface	Use it for
Skills	Persistent agent behavior, Starwind-specific rules, and project editing guidance.
MCP Server	Current lookup data and validated commands for components, docs, migrations, and Pro blocks.
Markdown docs	Focused page-level context by appending `.md` to the docs path.
`llms.txt`	Compact discovery and links to current AI surfaces.
`ai-manifest.json`	Structured inventory, framework availability, Skills, and MCP metadata.
`llms-full.txt`	Full static docs context when an agent cannot call MCP tools.

Use both Skills and MCP when your agent supports them. Skills provide project-editing guidance. MCP returns current Starwind data and validated commands.