# 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](https://github.com/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

```bash
npx 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](https://skills.sh).

## Update

Update both installed skills when Starwind publishes new guidance:

```bash
npx 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](/docs/getting-started/mcp/) when your agent supports them. Skills provide
project-editing guidance. MCP returns current Starwind data and validated commands.