User Manual

The Aivyx Hub is the community registry for agent Skills and Personas. Think of it as a library where you can discover capabilities built by the community and instantly add them to your private Aivyx Engine.

Every item in the Hub follows the Aivyx Handoff Protocol (AHP) — a standardized format that ensures compatibility with your local Cockpit. No accounts required, no data leaves your machine.

Skills are capabilities you can add to your agents. They define what an agent can do — from searching the web to writing code to analyzing data.

Each skill includes a manifest file that describes its capabilities, required tools, and configuration. When you sync a skill, your Cockpit downloads the manifest and configures your local agent accordingly.

Personas define an agent's personality, expertise, and behavior. They shape how your agent communicates and approaches tasks.

A persona template includes system prompts, behavioral guidelines, and suggested skill pairings. You can use community personas as-is or customize them to match your needs.

Every item has a “Sync to Cockpit” button. Here's how it works:

1. Click the button — This triggers an aivyx:// deep link.
2. Cockpit opens automatically — If Aivyx Cockpit is installed, it receives the manifest URL and begins the sync process.
3. Fallback: clipboard copy — If the deep link doesn't work, the manifest URL is automatically copied to your clipboard. You can paste it manually in Cockpit's import dialog.

Want to share your skills or personas with the community? Here's the process:

1. Create a manifest — Write a JSON manifest file following the AHP manifest format.
2. Host the manifest — Upload it to any publicly accessible URL (Git repository, CDN, personal server).
3. Submit for inclusion — Contact the Aivyx team to have your item added to the Hub registry.

A skill or persona manifest is a JSON file with the following structure:

{
  "id": "unique-skill-id",
  "schemaVersion": "1.0",
  "type": "skill",
  "name": "My Skill",
  "description": "What this skill does",
  "itemVersion": "1.0.0",
  "creator": {
    "username": "your-name",
    "url": "https://your-site.com"
  },
  "capabilities": ["code", "automation"],
  "tags": ["utility", "developer"],
  "manifestUrl": "https://example.com/manifest.json",
  "repository": "https://example.com/repo"
}

See the full schema documentation in the Hub's registry schema docs for all available fields including verified, downloads, and compatibility.