A governed path for skills, plugins, recipes, and templates
The marketplace surface is intentionally documentation-first until manifest validation, permission review, and submission workflows are ready.
No upload flow before validation
The public surface explains submission expectations without accepting unreviewed artifacts.
Permission-first listings
Every listing must make runtime access, secrets, network calls, and regional assumptions explicit.
Migration path from today
Current /skills and /plugins pages stay usable while listings gain manifest and review metadata.
Listing surfaces
Skills
Prompt and config bundles that teach an agent a repeatable workflow.
Plugins
Runtime integrations that expose tools without occupying prompt context.
Recipes
Task-specific Discover -> Inspect -> Call examples with expected parameters.
Templates
Starter projects that combine QVeris APIs, UI, auth, and deployment defaults.
Listing schema
nameRequiredHuman-readable listing name.
slugRequiredStable URL and manifest identifier.
versionRequiredSemantic version for upgrade and rollback decisions.
authorRequiredPerson, team, or organization responsible for maintenance.
kindRequiredOne of skill, plugin, recipe, or template.
permissionsRequiredNetwork, file, secret, browser, or tool permissions needed at runtime.
compatible_surfacesRequiredOpenClaw, CLI, MCP clients, IDEs, or hosted agents that can run it.
examplesRequiredRunnable examples that show expected inputs, outputs, and failure handling.
quality_statusRequiredObserved install success, smoke result, docs completeness, and owner freshness.
review_stateRequireddraft, submitted, reviewed, verified, or deprecated.
source_urlRequiredRepository, package, or release artifact used for review.
security_notesOptionalKnown limitations, sandbox assumptions, data handling, or regional constraints.
Migration path
Existing setup and skills pages remain the install-first path. New marketplace listings should reference those pages until each item has manifest metadata, permissions, examples, and review state.