Fragiola

Agent skills

Agent skills

The fragiola skill teaches Claude Code, Codex, Cursor and OpenCode to build with Fragiola UI and the headless libraries: npx skills add fragiola/skills.

The fragiola skill is loaded by your coding agent when it works with Fragiola. It teaches the components, the palettes, the composition rules and the headless libraries, so the code your agent writes follows the same rules as ours. It uses the open Agent Skills format: the agent reads it only when the task is about Fragiola.

Install

Run the skills CLI from your project:

npx skills add fragiola/skills

Add -g to install it for every project, or -a <agent> to pick the agent.

To install it without the CLI, copy skills/fragiola/ from the repository into your agent's skills folder:

cp -r skills/fragiola .claude/skills/

What the agent learns

Fragiola UI

Which components exist and how to add them with npx shadcn@latest add @fragiola/<name>. How to compose them: one namespace per component, render instead of asChild, complete dialogs and fields.

Palettes

Colour comes from palettes and their six roles (base, soft, line, contrast, accent, ring), never from raw colours. The skill covers fields, invalid states, secondary text and themes the way the design system expects.

Headless libraries

The npm packages (Dockable, Data Grid and Grid Layout): which adapter to install, what to import and how to style them through their state.

Works with

Claude Code, Codex, Cursor and OpenCode, and any other agent that supports skills.

Ask your agent

Once the skill is installed, ask in plain words. The agent loads it when the task is about Fragiola:

  • "Build a settings form with Fragiola fields and a danger palette for errors."
  • "Port this shadcn dialog to Fragiola UI."
  • "Add a dockable layout with tabs and a side panel."
  • "Show a million rows with the Fragiola data grid."

Better with the MCP server

The skill teaches the rules. The MCP server gives the agent the current components, docs and APIs on demand, and the skill tells the agent when to use each tool.