Skill guide · checked November 19, 2026

Alloy CSS Agent Skill: Install and Use

Short answer: The alloyhtml/css repository includes an agent skill, alloy-css, that tells your coding agent to write HTML using only Alloy CSS classes and values, never Tailwind or Bootstrap names. Copy it into your project with npx @alloyhtml/css skill, then verify the markup with npx @alloyhtml/css check. It works with Claude Code and, by pointing at its SKILL.md, other agents.

Want the tool itself first? Read Alloy CSS: Install, Classes and Agent Skill.

Install the Alloy CSS skills

The package ships the skill and a command that copies it. The default folder is .claude/skills/alloy-css; use --to for another agent. Alloy CSS itself loads from a CDN link, shown on the docs page.

# Claude Code: copies to .claude/skills/alloy-css
npx @alloyhtml/css skill

# Antigravity or Codex: pick the skills folder yourself
npx @alloyhtml/css skill --to .agents/skills/alloy-css

# afterwards, list classes the kit does not define
npx @alloyhtml/css check templates/

Source: alloyhtml/css and the official docs. We do not host a copy, so you always install the current version.

What each Alloy CSS skill does

The folder holds one skill (SKILL.md plus a reference.md with every class), so instead of a list of skills this table shows the rules in its SKILL.md. The descriptions are in our words; read the upstream file for the exact text.

SkillWhat it doesUse when
Only kit classesNever invent a class and never use Tailwind or Bootstrap names such as `mt-4` or `btn`.The agent keeps writing classes the stylesheet does not define.
Only kit valuesSpacing, gaps, radius and widths come from fixed scales, for example spacing 0 to 140 px and widths as percentages or fractions.Pages must stay visually consistent.
Semantic colorsUse surface, text and border names such as `bg-raised` and `text-secondary` for the page, and palette colors only for meaning like status.You want the page to follow dark and light themes.
No JavaScript for interactionsModals are `<dialog>` with `commandfor`, menus and drawers are popovers, accordions are `<details>`, tabs are radio buttons.The agent reaches for a script to open a modal or menu.
Breakpoints and one-offsA suffix such as `-sm` applies at that width and below; sizes the kit lacks go in an inline `style` attribute.You need a responsive layout or a one-off size.
Check your workRun `npx @alloyhtml/css check` on what was written and fix every class it lists.Before you accept the agent output.

Build a page with Alloy CSS and an agent

Based on the README and SKILL.md. You need Node.js for npx. We ran the install and check commands once on November 19, 2026; we did not build a full site.

  1. Add the stylesheet link from the README to your page head: <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alloyhtml/css@1/dist/alloy.min.css">.
  2. Run npx @alloyhtml/css skill (or add --to for Antigravity or Codex).
  3. Start your agent and ask for the page, for example "Build the settings page as server-rendered HTML with Alloy CSS".
  4. Run npx @alloyhtml/css check on your templates folder and ask the agent to fix any class it lists.

License and what we did not verify

The repository and the npm package are MIT-licensed (copyright Fandy Pradana) according to its LICENSE file and package.json. We link to the skill instead of hosting a copy. We did not find an alloy-css listing on skills.sh on November 19, 2026. The site says browsers need Chrome or Edge 135, Firefox 144 or Safari 26.2 and newer for its interactive parts. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.

FAQ

Does Alloy CSS have an agent skill?

Yes. The official repository has ai/alloy-css/SKILL.md and reference.md, and the npm package includes them.

How do I install the alloy-css skill?

Run npx @alloyhtml/css skill in your project. It copies the skill into .claude/skills/alloy-css, or into the folder you pass with --to.

Does it work in Antigravity and Codex?

The package says other AI tools can read the two Markdown files. Use --to to copy them into your agent skills folder, or point your AGENTS.md at the SKILL.md.

What does the check command do?

npx @alloyhtml/css check lists every class in your markup that the kit does not define, with its file and line, and exits with code 1 when it finds one.

Does Antigravity Skills host a copy of the skill?

No. This page links to the official repository and does not redistribute its files, so you install the current version.

Alloy CSS Agent Skill: Install and Use | Antigravity Skills