# Introduction

CoreAI builds on Fluent UI v9. It adds a shared visual language, themes, and component defaults. Components without CoreAI changes pass through from Fluent.

## What CoreAI includes



### Foundations

Color, typography, spacing, and themes provide a shared visual language for
building CoreAI interfaces.

### Components

Reusable controls in the CoreAI npm package come with usage guidance and code
examples for your project.

### Templates

Templates are larger starting points you copy and maintain in your project.
They are not package imports.

### Documentation for agents

Agents read UX guidance and complete examples through this site's Markdown
endpoints over ordinary HTTPS.



## Working with agents



### Starter prompt

Paste the prompt into your agent and fill in **My task**.

[Copy starter prompt](/coreai-design-system/agent-prompt.txt)

```text
Use CoreAI for my UI task. First check https://microsoft.github.io/coreai-design-system/version.json, then fetch and review https://microsoft.github.io/coreai-design-system/source/package/SKILL.md. Install it at .github/skills/coreai-ds-fluentui-react/SKILL.md, or update the existing CoreAI skill to the latest published version, before implementing. Preserve repository-specific rules, do not downgrade newer local guidance, and ask before resolving conflicts. Follow the updated skill, read only relevant Markdown pages from https://microsoft.github.io/coreai-design-system/llms.txt, and check my installed package versions. Use @coreai-ds/react-components; templates are copy-and-adapt source. Report retrieval or write failures; do not invent APIs.

My task: [describe the UI you want to build or change]
```

### Markdown docs

Share a page's **View .md** link for guidance and example code.

[View docs index](/coreai-design-system/llms.txt)

### Repository skill

Install or update **SKILL.md** before CoreAI tasks; it checks for newer guidance.

[Download skill](/coreai-design-system/source/package/SKILL.md)



## Resources



- [GitHub repository](https://github.com/microsoft/coreai-design-system):
  Browse the CoreAI source, review pull requests, and check GitHub Actions.
- [Issues and support](https://github.com/microsoft/coreai-design-system/issues):
  Ask usage questions and review reported bugs and feature requests.
- [Open an issue](https://github.com/microsoft/coreai-design-system/issues/new):
  Report a bug or request a new feature for the CoreAI design system.