By 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.23 # x-release-please-version
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.