Skip to main content
Version: MVP

Skill promotion gates

2 min readReferenceUpdated 2026-05-19

What you'll find here

The gates that prevent reviewed skill proposals from becoming promoted guidance without explicit approval — SkillPromotionRequest and SkillPromotionDecision.

Approver must not be an agent.

The approver is explicit and never an agent identity. Missing gates produce a denied decision with reviewable denial reasons.

Request​

SkillPromotionRequest:

Proposal id

Skill package id

Promoted version id

Approver

Policy envelope id

Evidence ids

Eval result ids

Receipt ids

Approval receipt id

Decision​

SkillPromotionDecision:

Request id

Proposal id

Skill package id

Decision status

approved · denied.

Approver

Promoted version id

Policy envelope id

Evidence ids · eval result ids · receipt ids

Denial reasons

Required gates​

Promotion is approved only when every gate is satisfied.

  1. The request references the same proposal, skill package, and policy envelope as the proposal.
  2. The proposal status is approved.
  3. The proposal has a structured improvement plan.
  4. The approver is explicit and not an agent identity.
  5. Evidence ids are present.
  6. Eval result ids are present.
  7. Receipt ids are present.
  8. An approval receipt id is present.

What's next​

ReferenceSkill proposalsThe proposal contract these gates accept or deny.ReferenceSkill replayThe replay results that compose with promotion.ReferenceLearning receiptsRecord promotion decisions.