alif-ui 2.0.0-alpha.2 → 2.0.0-alpha.20

package/README.md

@@ -134,6 +134,24 @@ If your project requires a brand:
 
 And here's where magic happens - all the components automatically adapt to that brand!
 
+# AI assisted development
+
+This repo also ships **agent skills** for AI assisted development — see `skills/`.
+
+`alif-ui` teaches AI coding assistants how to build UI with this library — setup, every component's props, our patterns and the mistakes to avoid — and adapts to the project it is installed in.
+
+The skill ships inside the package, so once `alif-ui` is installed one command puts it where your assistant looks:
+
+```bash
+npx alif-ui skills install
+```
+
+It installs into every assistant skill directory the project already has — any `.<assistant>/skills` folder, so Claude Code, Cursor, Windsurf and the shared `.agents/skills` are all found without us keeping a list. A project with none of them gets `.claude/skills/`; `--dir <path>` and `--global` override that. Re-run it after upgrading `alif-ui`, and commit the installed folder so your team gets it.
+
+Written in the open [Agent Skills](https://agentskills.io) format, so it works in Claude Code, Cursor, Copilot and other compatible assistants.
+
+A second skill, `alif-ui-contributor`, documents this repository for contributors and needs no installation. See **Guides → AI Assisted Development** in Storybook for details.
+
 # Documentation
 
 Visit [https://ui.alif.tj](https://ui.alif.tj) to view the full documentation.