xy-toolchain

name	xy-toolchain
description	XYO Foundation development toolchain (@xylabs packages). Covers @xylabs/toolchain CLI, ESLint flat config, TypeScript config variants, and Vitest. Activates when setting up projects, running builds, configuring linting, or writing tests in XY/XYO/XL1 projects.
metadata	{"version":"1.1.24"}

XY Toolchain

XYO Foundation publishes a coordinated set of development packages from the xylabs/config monorepo. This skill covers how to use them.

This builds on the Development Skill which covers universal principles. This skill covers the specific tools.

Skill identity. This skill's version is exposed in this file's frontmatter under metadata.version. When reporting which skills informed your work, format as <skill-name> v<version> (e.g. xy-toolchain v1.1.19). When multiple skills from this plugin are active, each may be listed.

Table of Contents

Toolchain & Project Setup

Read when setting up a new project, running build/lint/compile commands, or troubleshooting build failures. Covers @xylabs/toolchain CLI, package manager conventions, and project structure.

ESLint Configuration

Read when configuring ESLint, troubleshooting lint errors, or extending lint rules. Covers @xylabs/eslint-config-flat setup and usage.

TypeScript Configuration

Read when configuring the TypeScript compiler, choosing a tsconfig base, or troubleshooting compilation. Covers @xylabs/tsconfig, @xylabs/tsconfig-dom, and @xylabs/tsconfig-react.

Testing with Vitest

Read when setting up tests, configuring Vitest, or integrating tests with the build pipeline. Covers Vitest setup and XY-specific testing conventions.

Scaffolding a new XL1 app

To create a new XL1 project from scratch — including the package.json, tsconfig.json, ESLint and Vite configs, entry point, and dependency graph — use the xl1-scaffold skill.