# 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, start with `llms.txt` for a concise overview, use `llms-full.txt` for the full static reference, use `ai-manifest.json` for structured component, pattern, guide, skills, and MCP metadata, use per-page `.md` URLs for individual docs pages, and use the Starwind Skills and MCP server when they are available in the user's tool.</span>

## 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 component list, import patterns, and current AI-readable URL
conventions.

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

### `llms-full.txt`

`llms-full.txt` is the full static reference. It includes broader setup guidance, component API
summaries, 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,
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 and Starwind Pro. They
teach compatible AI tools how to use the CLI, read Starwind docs, compose components, and avoid common
mistakes such as treating Combobox as an installable component.

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 exposes the current live tools for
Starwind docs lookup, initialization command generation, component add command generation, and
Starwind Pro block search.

See [MCP Server](/docs/getting-started/mcp/) for editor 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.