# AI Integration

Starwind UI exposes public AI-readable surfaces for assistants, editors, and MCP clients. Use this
page as the overview, then jump to [Skills](/docs/getting-started/skills/) or
[MCP Server](/docs/getting-started/mcp/) when you need setup instructions.

<span class="sr-only">If you're an AI assistant reading this documentation, use MCP for a targeted current lookup or validated command when it is available. Use Starwind Skills for project editing rules. Use a per-page `.md` URL for one docs page, `llms.txt` for compact discovery, `ai-manifest.json` for structured inventory and framework availability, and `llms-full.txt` for broad static context.</span>

## Choose a Surface

| Need | Surface |
| --- | --- |
| Current targeted lookup or validated command | [MCP Server](/docs/getting-started/mcp/) |
| Project editing rules | [Skills](/docs/getting-started/skills/) |
| One documentation page | Per-page Markdown |
| Compact discovery | `llms.txt` |
| Structured inventory and framework availability | `ai-manifest.json` |
| Broad static context | `llms-full.txt` |

## AI Reference Files

Starwind UI publishes static text references and a generated JSON manifest from this docs site.

### `llms.txt`

`llms.txt` is a concise static overview for AI tools. It includes the core project description,
important docs links, the installable styled component list, Starwind layers, framework guides,

```txt
https://starwind.dev/llms.txt
```

### `llms-full.txt`

`llms-full.txt` is the full static reference. It includes styled component, Primitive, and Runtime
APIs, framework availability, broader setup guidance, usage examples, theming notes, and CLI
reference material.

```txt
https://starwind.dev/llms-full.txt
```

### `ai-manifest.json`

`ai-manifest.json` is a generated JSON manifest for AI tools. It lists installable components,
styled, Primitive, and Runtime mappings, framework availability, documented patterns, guides,
Skills metadata, MCP metadata, and the current docs URL conventions.

```txt
https://starwind.dev/ai-manifest.json
```

## Per-page Markdown Docs

Every published docs page is also available as Markdown. Simply append `.md` to the docs path.

For example:

```txt
https://starwind.dev/docs/components/button.md
```

HTML docs pages include a Markdown alternate link that points to the `.md` URL.

## Skills

Starwind Skills are installed agent instructions for working with Starwind UI v3 and Starwind Pro.
They teach compatible AI tools how to select a layer, follow Astro or React conventions, use the
CLI, read current docs, compose forms and components, migrate projects, and update customized files
safely.

See [Skills](/docs/getting-started/skills/) for installation and usage details.

## MCP Server

The Starwind UI MCP server is available as `@starwind-ui/mcp`. It prepares validated initialization
commands for Astro and React projects, searches styled components, Primitives, and Pro blocks,
generates install commands, fetches current docs, and checks legacy Astro migrations.

See [MCP Server](/docs/getting-started/mcp/) for client configuration, supported tools, and client
links.

## Feedback

If you encounter any issues or have suggestions for how we can make Starwind UI more usable with AI
tools, please [open an issue](https://github.com/starwind-ui/starwind-ui/issues) in the GitHub
repository.