# llms.txt > llms.txt for the HAX ecosystem — agent discovery and skill installation. ## HAX Ecosystem The HAX (Headless Authoring eXperience) ecosystem is a comprehensive web development platform for rapid creation of accessible, performant web components and static sites. It consists of a monorepo with 250+ LitElement components, a HAXcms content management system, a DDD design system, and extensive tooling. ## Worldview, Voice and Evidence Read these before writing anything public about HAX or making product decisions: - **WHY.md**: why HAX exists, in Bryan Ollendyke's words — https://github.com/haxtheweb/praw/blob/main/WHY.md - **WORLDVIEW.md**: what HAX believes; the seven community pillars, pillar checks for PRs, and the course ontology — https://github.com/haxtheweb/praw/blob/main/WORLDVIEW.md - **VOICE.md**: how HAX sounds; core message, audiences, signature lines, what the voice doesn't do — https://github.com/haxtheweb/praw/blob/main/VOICE.md - **WINS.md**: sourced impact stories to cite (never funding amounts) — https://github.com/haxtheweb/praw/blob/main/WINS.md - **impact/**: the data behind the wins (npm downloads, release velocity, merged PRs, SIIP timeline), refreshed with `node scripts/impact-stats.mjs` — https://github.com/haxtheweb/praw/tree/main/impact - **talks/**: notes and recordings of key talks — https://github.com/haxtheweb/praw/tree/main/talks ## Interface Skills (canonical source: `create`) The following interface skills are owned by the `create` repo (`@haxtheweb/create`, the `hax` CLI) and are version-locked to the CLI. They are NOT bundled in PRAW — install them from `create`: - **hax-webcomponent-dev**: Web component development with LitElement, DDD, and HAXSchema - Canonical source: `create/src/skills/hax-webcomponent-dev/` -> shipped via `dist/skills/` - **hax-site-building**: HAXcms site creation and theme management - Canonical source: `create/src/skills/hax-site-building/` -> shipped via `dist/skills/` - **hax-ecosystem-onboarding**: New developer onboarding and environment setup - Canonical source: `create/src/skills/hax-ecosystem-onboarding/` -> shipped via `dist/skills/` - **hax-claudehax**: Operate HAX sites via the HAX CLI and HAX web components - Canonical source: `create/src/skills/hax-claudehax/` -> shipped via `dist/skills/` - **hax-webcomponent-documentation-writer**: Generate/maintain HAX element READMEs from custom-elements.json + haxProperties - Canonical source: `create/src/skills/hax-webcomponent-documentation-writer/` -> shipped via `dist/skills/` Install all interface skills with: ```bash hax skills install --all ``` ## Workflow & Knowledge Skills (owned by PRAW) All skills below live in `skills/` in this repo. The machine-readable discovery index (names, descriptions, digests — agentskills.io discovery spec v0.2.0) is `.well-known/agent-skills/index.json`. A copy at `skills/index.json` sits beside the skill folders, so its relative entry URLs resolve when fetched remotely: `https://raw.githubusercontent.com/haxtheweb/praw/stable/skills/index.json` (the `stable` channel HAXsites point agents to; maintainers promote reviewed `main` to `stable`). - **audio-program-transcribe**: Transcribe and distill an owned audio/video program into a portable markdown staging tree - Path: `/skills/audio-program-transcribe/SKILL.md` - **audio-program-hax**: Publish a transcribed audio/video program as a searchable HAXcms library site with inline playback - Path: `/skills/audio-program-hax/SKILL.md` - **hax-a11y-audit**: Read-only WCAG 2.0 AA audit of authored HAX pages with HAX remediation - Path: `/skills/hax-a11y-audit/SKILL.md` - **hax-content-authoring**: Author HAX page content using HAX-capable web components, DDD attributes, and pages/ conventions - Path: `/skills/hax-content-authoring/SKILL.md` - **hax-content-chunking-audit**: Audit a HAX page for cognitive load / chunking and recommend HAX remediation - Path: `/skills/hax-content-chunking-audit/SKILL.md` - **hax-design-system**: DDD design system application and SimpleColors migration - Path: `/skills/hax-design-system/SKILL.md` - **hax-design-system-sync**: Maintain DDD across the ecosystem: lint and fix tokens, check contrast, regenerate DTCG tokens and references, rebuild and publish the claude.ai design system - Path: `/skills/hax-design-system-sync/SKILL.md` - **hax-i18n-translate**: Scaffold and translate HAX web component i18n locale files at scale - Path: `/skills/hax-i18n-translate/SKILL.md` - **hax-issue-analysis**: GitHub issue fetching and analysis across the ecosystem - Path: `/skills/hax-issue-analysis/SKILL.md` - **hax-issue-research**: Research a HAX GitHub issue, draft a plan, and capture it as a "Plan Created" comment - Path: `/skills/hax-issue-research/SKILL.md` - **hax-managed-files**: Know which HAXcms files are generated vs authored, and the protective rules around builds - Path: `/skills/hax-managed-files/SKILL.md` - **hax-openstax2hax**: Convert OpenStax books into HAX sites via the openstax2hax plugin - Path: `/skills/hax-openstax2hax/SKILL.md` - **hax-pattern-library-audit**: READ-ONLY diagnostic — analyze a single HAX web component against the DDD Atomic Design pattern library (composition conformance, internal contracts, library-ingest candidates) - Path: `/skills/hax-pattern-library-audit/SKILL.md` - **hax-rule-management**: PRAW rule management and validation - Path: `/skills/hax-rule-management/SKILL.md` - **hax-site-structure**: Read and navigate an existing HAXcms site from its portable files (site.json, pages/, files/, theme) - Path: `/skills/hax-site-structure/SKILL.md` - **hax-tutorial-site**: Create a published HAXcms tutorial site from a YouTube video and a DOCX transcript, plus LinkedIn / X posts - Path: `/skills/hax-tutorial-site/SKILL.md` - **hax-ubd-backward-design**: Design HAX course units via UbD backward design; emits unit plan + HAX site skeleton - Path: `/skills/hax-ubd-backward-design/SKILL.md` - **hax-ubd-essential-questions**: Author UbD essential and entry questions from the six-facet starter bank - Path: `/skills/hax-ubd-essential-questions/SKILL.md` - **hax-ubd-grasps**: Frame UbD GRASPS performance tasks and pick authentic-context HAX media - Path: `/skills/hax-ubd-grasps/SKILL.md` - **hax-ubd-six-facets**: Apply UbD six facets to write understandings and build facet-mapped rubric criteria - Path: `/skills/hax-ubd-six-facets/SKILL.md` - **hax-ubd-stage1**: UbD Stage 1 — unpack standards into big ideas, understandings, EQs, K/S, misconceptions - Path: `/skills/hax-ubd-stage1/SKILL.md` - **hax-ubd-stage2**: UbD Stage 2 — build evidence scrapbook, GRASPS task, facet rubric, validity self-test - Path: `/skills/hax-ubd-stage2/SKILL.md` - **hax-ubd-stage3**: UbD Stage 3 — plan learning experiences via WHERETO from Stages 1+2 - Path: `/skills/hax-ubd-stage3/SKILL.md` - **hax-ubd-unit-audit**: Read-only UbD review of an existing HAX unit with remediation handoff - Path: `/skills/hax-ubd-unit-audit/SKILL.md` - **siip-course-alignment**: Align a course with an open source project via the Sustainable Impact and Innovation Pipeline (term shape, contribution map, lab/club loop) - Path: `/skills/siip-course-alignment/SKILL.md` - **hax-udl-audit**: Read-only UDL 3.0 audit (Engagement, Representation, Action & Expression) of a HAX page - Path: `/skills/hax-udl-audit/SKILL.md` - **haxcms-lrs-rater**: Run BookLooky's Looky Rating System (LRS) content rating and minimum-age recommendation on a HAXcms site's aggregated content - Path: `/skills/haxcms-lrs-rater/SKILL.md` - **heosat**: Run the HEOSAT (Higher Education Open Source Assessment Tool) maturity assessment on an open source project into an evidence-backed scorecard - Path: `/skills/heosat/SKILL.md` - **heosat-report-site**: Publish a HEOSAT assessment as a single-page HAXcms report site on surge, with scorecard, evidence, and social copy - Path: `/skills/heosat-report-site/SKILL.md` - **oerschema-audit**: Read-only OER Schema diagnostic of authored content (HAX pages, VitePress, JSON-LD, Docs export) - Path: `/skills/oerschema-audit/SKILL.md` - **oerschema-integration-finder**: Read-only scan of webcomponents/themes/backends/plugins for missing OER Schema emission/consumption - Path: `/skills/oerschema-integration-finder/SKILL.md` - **hax-backend-dev**: Keep haxcms-nodejs and haxcms-php in step: mirror routes and OpenAPI specs, use @site/ or @system/ MFR namespaces - Path: `/skills/hax-backend-dev/SKILL.md` - **hax-importer-dev**: Build a site importer end to end: Node and PHP converters, dispatcher, OpenAPI spec, API error codes, client service and chooser card, i18n and tests - Path: `/skills/hax-importer-dev/SKILL.md` - **hax-testing**: Find and run the right tests per HAX repo and write the test for a new endpoint - Path: `/skills/hax-testing/SKILL.md` - **hax-release-prep**: Verify locally and write the maintainer handoff for the ubiquity build and publish steps agents must never run - Path: `/skills/hax-release-prep/SKILL.md` - **hax-element-demo**: Build a throwaway demo of a HAX element inside the real HAX editor (h-a-x) as static files, to check app-store wiring and editability - Path: `/skills/hax-element-demo/SKILL.md` - **grad-blooms**: Classify learning objectives and design assessments with Bloom's revised taxonomy - Path: `/skills/grad-blooms/SKILL.md` - **hax-proficiency-scaffolding**: Fit a unit's scaffolding to its learners' stage (novice to expert) with ELEVATE-XR: objective level, learning loop, and the stress, complexity, assistance, feedback and fidelity dials mapped to HAX elements - Path: `/skills/hax-proficiency-scaffolding/SKILL.md` - **hax-feedback-design**: Write and audit feedback, hints and evidence for HAX question elements at the right level for the learner - Path: `/skills/hax-feedback-design/SKILL.md` - **hax-practice-and-retrieval**: Plan retrieval practice, spacing, interleaving and deliberate practice across a HAX site - Path: `/skills/hax-practice-and-retrieval/SKILL.md` - **hax-reflection-prompts**: Write stage-matched reflection prompts (summarize, exemplify, relate, contradict, self-critique) for HAX pages - Path: `/skills/hax-reflection-prompts/SKILL.md` - **reading-notes**: Draft paragraph-level Reading Notes for a long reading (topic rows, page ranges, first…last word anchors, one-sentence paraphrases) for human review - Path: `/skills/reading-notes/SKILL.md` - **hax-instructional-events-audit**: Read-only audit of a HAX lesson against Gagné's nine events and Merrill's First Principles - Path: `/skills/hax-instructional-events-audit/SKILL.md` - **hax-multimedia-principles-audit**: Read-only audit of how a HAX page combines words and media against Mayer's multimedia principles - Path: `/skills/hax-multimedia-principles-audit/SKILL.md` - **hax-theme-builder**: Turn a screenshot into an accessible, dark-mode-ready HAXcms theme - Path: `/skills/hax-theme-builder/SKILL.md` - **youtube-vtt**: Generate a WebVTT transcript from a YouTube URL with yt-dlp, no video download - Path: `/skills/youtube-vtt/SKILL.md` ## Claude Code Plugin Marketplace PRAW hosts a Claude Code plugin marketplace with three plugins: ```text /plugin marketplace add haxtheweb/praw /plugin install hax-onboarding@haxtheweb ``` - **hax-onboarding** — Golden-path onboarding: auto-installs the HAX CLI, ships a knowledge skill, and provides slash commands (quickstart, site, webcomponent, audit, serve, publish). - **hax-site-ops** — Operate HAX sites from Claude Code: add pages, create courses, update content, inspect, validate, and publish. (Renamed from the old `hax` plugin in claudehax.) - **openstax2hax** — Prepare OpenStax books for conversion into HAX sites. ## Install Workflow Skills ```bash npx skills add haxtheweb/praw --all # Or install individually npx skills add haxtheweb/praw --skill hax-design-system npx skills add haxtheweb/praw --skill hax-openstax2hax ``` ## Companion Skills (install separately) The Anthropic document skills (`docx`, `pdf`, `pptx`, `xlsx`) are source-available, not open source, and are NOT bundled in this repo. Install them from Anthropic's official repo on your machine: ```bash npx skills add anthropics/skills --skill docx --skill pdf --skill pptx --skill xlsx -g -y ``` ## Documentation - PRAW Repository: https://github.com/haxtheweb/praw - HAX Documentation: https://haxtheweb.org/ - DDD Design System: https://haxtheweb.org/ddd - HAX CLI: https://www.npmjs.com/package/@haxtheweb/create ## Community - Discord: https://discord.gg/aCGxmRHEJP - Issues: https://github.com/haxtheweb/issues - Twitter/X: https://x.com/haxtheweb