mayros hub

Apilium Hub marketplace commands. Search, install, update, rate, verify, and publish semantic skills. Manage Ed25519 signing keys and Hub authentication.

Subcommands

hub search <query>

Search the Hub for skills by keyword.

Options:

hub install <slug>

Install a skill from the Hub. Resolves the full dependency graph, installs skills in topological order, runs signature and integrity verification, and updates the lockfile.

Options: --version <ver> — install a specific version

hub update [slug]

Update installed Hub skills. Compares local signatures against the latest published version and runs verification before promoting.

Options: --all — update all installed skills (when no slug is given)

hub publish <dir>

Package, sign (Ed25519), and publish a skill directory to the Hub. Reads name, description, version, and dependencies from SKILL.md frontmatter. Creates SKILL.sig automatically.

Options: --changelog <text> — changelog entry for this version

hub verify <dir>

Run the verification pipeline locally on a skill directory. Checks static analysis, manifest validation, and optional Cortex sandbox tests. Reports pass/fail per step.

hub deps <slug>

Show the full dependency tree for a Hub skill, resolved in installation order.

Options: --version <ver> — resolve dependencies for a specific version

hub rate <slug> <score>

Rate a skill on the Hub (1-5 stars). Displays the updated average rating and total rating count.

hub audit [slug]

Audit skill dependencies for security issues. Checks installed skills against known vulnerability patterns.

Options: --all — audit all installed skills (when no slug is given)

hub categories

List all available skill categories with IDs, names, and icons.

hub browse <category>

Browse skills filtered by category ID.

Options: --limit <n> — maximum results (default: 10)

hub login

Authenticate with the Hub using Ed25519 challenge-response. Requires a keypair (see hub keys init). Stores the auth token locally.

hub whoami

Show the currently logged-in Hub identity (name, ID, registration date).

Key management

hub keys init

Generate a new Ed25519 keypair for skill signing and Hub authentication.

hub keys show

Display the current public key.

hub keys export

Export the public key in a format suitable for Hub registration.

mayros forge

Semantic skill development tools. Scaffold, test, autocomplete, and publish skills.

Subcommands

forge init <name>

Scaffold a new semantic skill with the given name. Creates a skills/<name>/ directory containing:

• SKILL.md — manifest with default permissions, queries, and instructions
• skill.ts — runtime handler implementing the SkillRuntime contract

forge autocomplete <ctx>

Get ontology-aware completions from Cortex. Queries known predicates in the current namespace and filters by the provided context string. Returns matching predicates as JSON.

forge test <dir>

Test a skill against a Cortex sandbox. Creates a temporary sandbox namespace, runs the full verification pipeline, and cleans up the sandbox afterward.

forge publish <dir>

Alias for mayros hub publish. Signs and publishes the skill directory to the Hub.

Examples

bashCopy
# Hub marketplace
mayros hub search "code review"
mayros hub search "security" --category analysis --limit 5
mayros hub install verify-kyc
mayros hub install verify-kyc --version 1.2.0
mayros hub update --all
mayros hub publish ./skills/my-skill --changelog "Added retry logic"
mayros hub verify ./skills/my-skill
mayros hub deps verify-kyc
mayros hub rate verify-kyc 5
mayros hub audit --all
mayros hub categories
mayros hub browse analysis

# Authentication
mayros hub keys init
mayros hub keys show
mayros hub keys export
mayros hub login
mayros hub whoami

# Skill development
mayros forge init my-new-skill
mayros forge autocomplete "project:"
mayros forge test ./skills/my-skill
mayros forge publish ./skills/my-skill

Related

• Skills Hub — marketplace architecture and trust model
• Skills — semantic skill authoring guide