XL1 / XYO development skills for AI coding assistants. The same skill content is published to agent skill marketplaces and to Skills.sh, so you can install it whichever way fits your workflow.
Six skill layers that cascade top-down:
| Layer | Skill | Covers |
|---|---|---|
| 6 | xl1-scaffold |
Bootstrap new XL1 apps (React dApp, Node service, monorepo) |
| 5 | xl1-patterns |
Commit-reveal, chain data indexing, in-page datalakes, prediction markets |
| 4 | xl1-knowledge |
XL1 chain, datalakes, gateway, browser wallet |
| 3 | xyo-knowledge |
XYO payloads, bound witnesses, modules, identity |
| 2 | xy-toolchain |
@xylabs/toolchain, ESLint flat config, TypeScript config, Vitest |
| 1 | xy-development |
TypeScript, Git workflow, testing, dev conventions |
Skills use progressive loading — each SKILL.md is a lightweight router that directs the agent to read sub-files on demand based on task context.
Agent skills are just Markdown files with YAML frontmatter (name, description). That format is portable across the major coding agents and skill registries, so this repo is a single source of truth — you're getting the same skills regardless of how you install them.
The Claude Code and Codex marketplaces require incompatible repository layouts, so each release renders marketplace-shaped trees into dedicated mirror repos. Install URLs point at the mirror for your tool; the source of the skills (and where to file issues or PRs) is always this repo:
| Install via | Repo to point at | Notes |
|---|---|---|
| Claude Code marketplace | XYOracleNetwork/xyo-claude-plugin |
Mirror — written by release automation. |
| Codex marketplace | XYOracleNetwork/xyo-codex-plugin |
Mirror — written by release automation. |
| Skills.sh | XYOracleNetwork/xyo-skills |
Source of truth. |
Browse and install through your coding agent's built-in skill marketplace.
# Add the marketplace
/plugin marketplace add XYOracleNetwork/xyo-claude-plugin
# Install the XL1 skill stack
/plugin install xyo-skillsThe /plugin slash commands aren't available in the Claude Code desktop app — use the Customize panel instead:
-
Click Customize in the left sidebar.
-
Under Personal plugins, click the + button.
-
Choose + Create plugin.
-
Choose Add marketplace.
-
In the URL field, paste
https://github.com/XYOracleNetwork/xyo-claude-pluginand click Sync.
-
In the plugin directory that opens, click the Code tab in the top row, then the xyo-skills marketplace pill in the second row. Find Xyo skills and click the + to install.
Add to your project's .claude/settings.json so the marketplace is auto-discovered for everyone on the team — works in both the CLI and the desktop app:
{
"extraKnownMarketplaces": {
"xyo-skills": {
"source": {
"source": "github",
"repo": "XYOracleNetwork/xyo-claude-plugin"
}
}
}
}Each team member then installs the plugin through their preferred interface (CLI or desktop app) using the steps above.
# Add the marketplace
codex plugin marketplace add XYOracleNetwork/xyo-codex-plugin --ref main
# Install the XL1 skill stack
codex plugin add xyo-skills@xyo-skillsAfter installing or updating the plugin, start a new Codex thread so the skill list is refreshed.
For development against a local clone of this repo, render the Codex tree and register it as a local marketplace — see DEVELOPMENT.md for details.
Skills.sh is an open-source CLI from Vercel that installs agent skills into any of 50+ supported coding agents — including Claude Code, Cursor, Codex, OpenCode, Gemini CLI, and more. Use this route if your agent isn't on a marketplace, if you want a single command to install across multiple agents at once, or if you want skills installed globally on your machine.
- Node.js (latest LTS recommended — download from nodejs.org)
npxships with Node.js, so no separate install is needed.
Run from the root of your project. Skills are written into your agent's project-local folder (e.g. .claude/skills/ for Claude Code), which you can commit alongside the project so anyone who clones it gets the same skills.
npx skills add XYOracleNetwork/xyo-skills --allInstalls into your home directory (e.g. ~/.claude/skills/) so the skills are available across every project on your machine.
npx skills add XYOracleNetwork/xyo-skills --all -g-
Windows: Skills.sh defaults to symlinking, which on Windows requires either Developer Mode or running your terminal as Administrator. The easier fix is to add
--copy, which copies files instead:npx skills add XYOracleNetwork/xyo-skills --all --copy
-
macOS / Linux: Symlinks work out of the box — no extra setup needed.
npx skills update # update all installed skills
npx skills remove # remove skills (interactive)
npx skills list # show what's installedFull CLI reference: vercel-labs/skills.
For local development, editing skills, building the scaffold package, and the release process, see DEVELOPMENT.md.