Skills

AI Skills are specialized expert guides that enable AI agents (like Gemini CLI, Cursor, or ChatGPT) to understand how to build applications using Buridan UI.

Instead of the AI simply "guessing" or copy-pasting code, a Skill provides it with procedural knowledge, such as using our CLI for dependency resolution and following our OKLCH theming system.

Gemini CLI

Buridan UI provides a specialized .skill file for the Gemini CLI. When activated, the agent becomes an expert in our design system.

Activation

gemini activate buridan-support

Key Capabilities

  • CLI-First: The agent knows to run buridan add <component> instead of manual code copying.
  • Dependency Resolution: Automatically identifies and adds required utilities and icons.
  • Theming: Understands how to correctly modify assets/globals.css using OKLCH variables.
  • Patterns: Automatically uses @layout_decorator and ClientStateVar for new pages.

Cursor and Windsurf

For users of Cursor or Windsurf, we provide a .cursorrules file in the project root. This acts as a persistent instruction set that forces the AI to follow Buridan UI's architectural best practices.

OpenAI and Claude

Our documentation is "AI-Ready" via the llms.txt file located in the root of the repository. You can provide this URL to any LLM to give it context on how to use Buridan UI correctly.

https://buridan-ui.reflex.run/llms.txt