@haxtheweb/create/dist/skills/hax-ecosystem-onboarding/SKILL.md

CLI for all things HAX the web

---
name: hax-ecosystem-onboarding
description: >
  Onboard new developers to the HAX ecosystem by cloning repositories, installing the CLI,
  and setting up the development environment. Use when a developer is new to HAX, needs a
  fresh environment setup, or wants to scaffold their first web component or HAXsite.
version: 1.1.0
license: Apache-2.0
metadata:
  author: haxtheweb
  tags: [hax, onboarding, setup, cli, environment, scaffolding]
  source: create
---

# HAX Ecosystem Onboarding

Onboard new developers to the HAX ecosystem by cloning repositories, installing the CLI, and setting up the development environment.

## When to Use

- A developer is new to the HAX ecosystem
- Setting up a fresh development environment
- Cloning all necessary HAX repositories
- Installing and configuring the HAX CLI (@haxtheweb/create)
- Scaffolding the first web component or HAXsite
- Creating development aliases and shortcuts

## How It Works

1. **Clone Repositories**: Clone all necessary HAX ecosystem repositories into `~/Documents/git/haxtheweb/`. Core repos include `webcomponents`, `create`, `haxcms-php`, `haxcms-nodejs`, `desktop`, `hax11ty`, `json-outline-schema`, `hax-schema`, `open-apis`, `docs`, and `issues`.
2. **Install HAX CLI**: Install globally with `npm install @haxtheweb/create --global`. Alternatively use `npx @haxtheweb/create` or `npm init @haxtheweb`. Update with `hax update`.
3. **Install Agent Skills**: Run `hax skills install --all` to install the bundled interface skills (site building, ClaudeHAX, web component dev, onboarding) into `~/.agents/skills/` so any agent can use them.
4. **Configure Environment**: Set up Warp with HAX-specific rules. Create helpful development aliases. Configure shell to start in `~/Documents/git/haxtheweb/`. (PRAW Rule `bAKMWCMrqRLGdWmuNWgVUw`)
5. **Scaffold First Component**: Use `hax webcomponent my-element --y` to create a LitElement with DDD and i18n support.
6. **Scaffold First Site**: Use `hax site mysite --y` to generate a HAXcms-based static site.
7. **Run Development Server**: Use `hax serve` to launch the site at http://localhost.

## HAX CLI Core Commands

- `hax start` — Start interactive CLI with ASCII art via Clack
- `hax serve` — Start development server
- `hax webcomponent <name> --y` — Create a web component
- `hax site <name> --y` — Create a HAXsite
- `hax audit` — Run DDD compliance audit on CSS
- `hax skills list` — List bundled agent skills
- `hax skills install <name|--all>` — Install bundled skills into `.agents/skills/`
- `hax update` — Update HAX CLI

## CLI Options for Automation

When scripting HAX commands, always use these flags to prevent interruptions:
- `--y` or `--auto` — Auto-accept all prompts
- `--no-i` — Prevent interactive sub-processes
- `--skip` — Skip animations for faster execution
- `--quiet` — Suppress console logging

## Quick Verification

After setup, verify the environment:
1. Run `hax --version` to confirm CLI installation
2. Run `hax webcomponent test-element --y` to verify scaffolding works
3. Run `hax site test-site --y` to verify site creation works
4. Run `hax skills list` to confirm bundled skills are available
5. Check that `~/Documents/git/haxtheweb/` contains the expected repositories

## References

- HAX CLI: `hax --help`
- PRAW (workflows + rules): `~/Documents/git/haxtheweb/praw/`
- PRAW RULES.md: `~/Documents/git/haxtheweb/praw/RULES.md` (canonical ecosystem rules)
- HAX Documentation: `https://haxtheweb.org/`