OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Install a signed skill artifact after verification checks.
Goal
Enforce trusted skill onboarding with provenance guarantees.
Context
Used by the control plane or marketplace workflows when enabling new skills.
Source Definition
export const ControlPlaneSkillInstallCommand = defineCommand({
meta: {
key: 'controlPlane.skill.install',
title: 'Install Skill Artifact',
version: '1.0.0',
description: 'Install a signed skill artifact after verification checks.',
goal: 'Enforce trusted skill onboarding with provenance guarantees.',
context:
'Used by the control plane or marketplace workflows when enabling new skills.',
domain: CONTROL_PLANE_DOMAIN,
owners: CONTROL_PLANE_OWNERS,
tags: [...CONTROL_PLANE_TAGS, 'skills'],
stability: CONTROL_PLANE_STABILITY,
},
capability: {
key: 'control-plane.skill-registry',
version: '1.0.0',
},
io: {
input: ControlPlaneSkillInstallInput,
output: ControlPlaneSkillInstallOutput,
errors: {
SIGNATURE_INVALID: {
description: 'The submitted artifact signature is invalid.',
http: 400,
when: 'Signature verification fails for the supplied artifact digest.',
},
COMPATIBILITY_MISMATCH: {
description:
'The skill is incompatible with runtime contract versions.',
http: 409,
when: 'Compatibility constraints do not match the active control plane version.',
},
},
},
policy: {
auth: 'admin',
pii: [],
},
sideEffects: {
emits: [
{
ref: ControlPlaneSkillInstalledEvent.meta,
when: 'Skill validation and installation complete successfully.',
},
],
},
});