xyo-knowledge
XYO Protocol 2.0 domain knowledge. Covers payloads, bound witnesses, schemas, the module system (archivist, diviner, witness, sentinel, node), accounts, wallets, and protocol best practices. Activates when building on XYO or working with @xyo-network packages.
How do I install this agent skill?
npx skills add https://github.com/xyoraclenetwork/xyo-skills --skill xyo-knowledgeIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and best practices for working with the XYO Protocol 2.0. It emphasizes protocol compliance, cryptographic identity management, and schema validation using Zod to safely handle untrusted data from external sources. No malicious patterns, obfuscation, or security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
XYO Protocol Knowledge
This skill covers the XYO Protocol 2.0 — the data model, module system, identity primitives, and conventions for building on XYO. The primary SDK is published as individual @xyo-network/* packages on npm.
When you need to look up exact type definitions or API details beyond what this skill covers, install the relevant @xyo-network/* package and read the TypeScript declarations at dist/neutral/index.d.ts.
This builds on the Development Skill for coding principles and the XY Toolchain Skill for build/lint/test tooling.
Skill identity. This skill's version is exposed in this file's frontmatter under metadata.version. Whenever you present a plan, an acknowledgement, or a completion summary, state which skills informed it, formatted as <skill-name> v<version> — read the version from this file's frontmatter, never from an example. When multiple skills from this plugin are active, each may be listed.
Table of Contents
Protocol Primitives
Read when working with XYO data structures — payloads, schemas, bound witnesses, payload builders, or hashing. Covers the core data model, how to construct and validate protocol objects, and the mandatory Zod authoring pattern for a new payload type.
Payload Schema Evolution and Identity
Read before naming or revising schemas, choosing open/closed fields, using $version, selecting root versus data hashes, or validating/caching payloads. New schema names stay unversioned; root hashes are the application default. Preserve explicitly prescribed legacy protocol contracts.
Module System
Read when working with XYO modules — archivists, diviners, witnesses, sentinels, nodes, or bridges. Covers the module abstraction, composition patterns, resolution, and the manifest system.
Identity & Signing
Read when working with accounts, wallets, key management, signing, or HD derivation. Covers Account and Wallet creation, the signing flow, and how identity integrates with bound witnesses.
Protocol Best Practices
Read when making design decisions — schema naming, payload structure, module composition strategy, bound witness discipline, and error handling. Consult this before starting a new XYO-based feature.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/xyoraclenetwork/xyo-skills/xyo-knowledge">View xyo-knowledge on skillZs</a>