Propose an uploaded standard Skill package

POST
/v1/skill/package/propose

Canonicalize exact ZIP bytes, store them once, and create a pending Candidate without LLM rewriting.

Authorization

BearerAuth
AuthorizationBearer <token>

Static bearer token used when local Server authentication is enabled.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/skill/package/propose" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "archive_base64": "string"  }'
{  "candidate_id": "string",  "version": 1,  "family": "experience",  "status": "pending",  "proposal": {    "situation": "string",    "action": "string",    "outcome": "string",    "lesson": "string"  },  "source_refs": [    {      "name": "string",      "source_id": "string"    }  ],  "artifact_refs": [    {      "family": "string",      "artifact_id": "string",      "revision": 1    }  ],  "target": {    "family": "string",    "artifact_id": "string",    "revision": 1  },  "reason": "string",  "result_artifact": {    "family": "string",    "artifact_id": "string",    "revision": 1  },  "decision_reason": "string"}

Download an exact managed Skill package POST

Return canonical ZIP bytes as bounded base64 with their content-addressed reference.

Record a bounded Skill usage observation POST

Validate an exact managed Skill Revision and capture immutable bounded usage Source evidence.