Skip to main content
POST
Propose a new version of a Library skill for review instead of publishing it (agents use this). Requires --execute.

Body

application/json
dir
string
required

Skill folder holding SKILL.md (relative to your current directory)

draft
boolean

Save a draft only you and the scope's reviewers see; do not submit

execute
boolean

Confirm the proposal (without it, print the plan and exit 3)

external
boolean

Allow loading this skill in conversations with people outside the organization

name
string

Display name (default: SKILL.md name, else the slug)

note
string

Note for the reviewers, at most 500 characters

rebase
boolean

With --update: move the proposal onto the version published now (read it first)

scope
string

org, or the Console project slug the skill belongs to

slug
string

Library slug (default: SKILL.md name, else the folder name)

update
string

Replace the content of your open proposal with this number

Response

Success — body conforms to the @Returns schema.

baseVersion
number
required
created
boolean
required
currentVersion
number
required
next
string
required
number
number
required
proposal
object
required
ref
string
required
round
number
required
stale
boolean
required
status
enum<string>
required
Available options:
draft,
proposed,
published,
superseded,
rejected,
withdrawn
success
boolean
required