Skill guide · checked November 19, 2026

Astryx Skills: Install and Use

Short answer: Astryx, the open-source React design system from Meta, ships one official agent skill rather than a pack. It tells a coding agent that Astryx is available through the astryx command and when to use it. For Claude Code, install it with claude plugin marketplace add meta/astryx, then claude plugin install astryx@astryx.

Want the tool itself first? Read What Is Astryx? Meta's React Design System for AI Agents.

Install the Astryx skills

The plugin README in the repository gives the Claude Code commands. For Codex it only says to add meta/astryx as a marketplace and enable astryx@astryx, and it gives no command line for that. The skill itself only points the agent at the CLI, so the CLI also needs to be installed.

# Claude Code: install the plugin that carries the skill
claude plugin marketplace add meta/astryx
claude plugin install astryx@astryx

# The CLI the skill points to (install once for the whole computer)
npm i -g @astryxdesign/cli

# Or inside a project, as the README's getting-started step shows
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli

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

What each Astryx skill does

The repository has exactly one skill, at plugins/astryx/skills/astryx. It is a short instruction file, not a library of component docs: the plugin README says it carries no component docs and names no version, and that the CLI answers those. The "use when" column is our reading of the skill description, not an official recommendation.

SkillWhat it doesUse when
astryxTells the coding agent that the Astryx design system is reachable through the `astryx` command, and points it at search, component, docs and template commands instead of guessing.You are building or changing UI, choosing components, or theming an app that uses the @astryxdesign packages.

How the skill expects the agent to work

These steps come from the skill file and the main README. Astryx needs React 19 or later, and the project is marked Beta in its README.

  1. Add @astryxdesign/core and @astryxdesign/cli to the project (or install the CLI globally), then run astryx init in the project and follow the agent docs it writes.
  2. To make a page, run astryx build "<what the page is for>" first. It names the template to start from and the parts that template lacks.
  3. Scaffold with astryx template <name> <path>, keep the template frame, and replace its content. Read props with astryx component <Name> before using a component.
  4. Before delivering, re-read each file and replace raw div or span elements, imported CSS and hardcoded hex or pixel values with a component or a token, then build the project.

License and what we did not verify

When we checked on November 19, 2026, the repository LICENSE file read "MIT License, Copyright (c) 2026 Meta Platforms, Inc." and GitHub reports the SPDX id MIT. The repository github.com/facebook/astryx redirects to github.com/meta/astryx, which is the address we link. The README marks the project as Beta, so commands may change. We have not run this skill or the CLI ourselves; every command and description above comes from the official README, the CLI README and the plugin README. We did not verify the Codex marketplace steps beyond that single README sentence, and we did not test which agents astryx init supports. Confirm everything on the official pages before relying on it. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.

FAQ

What are the Astryx skills?

There is one: a short skill that tells a coding agent Astryx is installed and when to reach for the astryx command. The repository ships it inside a plugin for Claude Code and Codex. The real reference material (components, docs, templates, themes) is served by the CLI, not by the skill.

How do I install the Astryx skill in Claude Code?

Run claude plugin marketplace add meta/astryx and then claude plugin install astryx@astryx, as the plugin README states. The skill calls the astryx command, so install the CLI too, for example with npm i -g @astryxdesign/cli.

Does the Astryx skill work without the CLI?

The skill file only instructs the agent to use the astryx command and says to run npm i -g @astryxdesign/cli if the command is not found. We did not test the skill without the CLI, but its instructions assume the CLI is available.

Is the Astryx skill the same as the global install?

The plugin README says the plugin skill is the same guidance that the global CLI install writes to ~/.agents/skills/astryx/SKILL.md. Installing both is therefore redundant for the skill text; the README recommends the global CLI plus a project-local copy for the CLI itself.

Does Antigravity Skills host a copy of the Astryx skill?

No. This page links to the official repository and does not redistribute its files. Install from the official source so you get the current version.

Astryx Skills: Install and Use | Antigravity Skills