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.

controlPlane.skill.install

Install a signed skill artifact after verification checks.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: skills
  • File: packages/libs/contracts-spec/src/control-plane/commands/controlPlaneSkillInstall.command.ts
  • field.key.label
    controlPlane.skill.install
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    controlPlane.skill.install
    field.description.label

    Install a signed skill artifact after verification checks.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: skills
  • File: packages/libs/contracts-spec/src/control-plane/commands/controlPlaneSkillInstall.command.ts
  • field.tags.label
    skills
    field.owners.label
    field.stability.label

    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.',
          },
        ],
      },
    });