xyo-skills

XYO Skills

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.

What's Included

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.

How These Work in Multiple Places

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 that each install method consumes directly — you're getting the same skills regardless of how you install them.

Install

Marketplaces

Browse and install through your coding agent's built-in skill marketplace.

Claude Code

Claude Code CLI

# Add the marketplace
/plugin marketplace add XYOracleNetwork/xyo-skills

# Install the XL1 skill stack
/plugin install xyo-skills

Claude Desktop app

The /plugin slash commands aren't available in the Claude Code desktop app — use the Customize panel instead:

1. Click Customize in the left sidebar.

   

2. Under Personal plugins, click the + button.

   

3. Choose + Create plugin.

   

4. Choose Add marketplace.

   

5. In the URL field, paste https://github.com/XYOracleNetwork/xyo-skills and click Sync.

   

6. 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.

   

Claude Team Setup

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-skills"
      }
    }
  }
}

Each team member then installs the plugin through their preferred interface (CLI or desktop app) using the steps above.

OpenAI Codex

Codex CLI

# Add the marketplace
codex plugin marketplace add XYOracleNetwork/xyo-skills --ref main

# Install the XL1 skill stack
codex plugin add xyo-skills@xyo-skills

After installing or updating the plugin, start a new Codex thread so the skill list is refreshed.

Local checkout

For development against a local clone, register the checkout as a local marketplace:

codex plugin marketplace add /absolute/path/to/xyo-skills
codex plugin add xyo-skills@xyo-skills

The Codex marketplace catalog lives at .agents/plugins/marketplace.json (the canonical repo-scoped path per OpenAI's docs) and the plugin manifest at .codex-plugin/plugin.json.

Skills.sh

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.

Prerequisites

• Node.js (latest LTS recommended — download from nodejs.org)
• npx ships with Node.js, so no separate install is needed.

Per-project install

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 --all

Global install