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.
| Skill | What it does | Use when |
|---|---|---|
Only kit classes | Never 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 values | Spacing, 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 colors | Use 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 interactions | Modals 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-offs | A 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 work | Run `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.
- 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">. - Run
npx @alloyhtml/css skill(or add--tofor Antigravity or Codex). - Start your agent and ask for the page, for example "Build the settings page as server-rendered HTML with Alloy CSS".
- Run
npx @alloyhtml/css checkon 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.
