---
title: "Create a local server-side remix draft"
method: POST
path: "/repos/{owner}/{repo}/remixes"
---

# Create a local server-side remix draft

`POST /repos/{owner}/{repo}/remixes`

## Request

- Base URL: `https://superskill.sh/api`
- URL: `https://superskill.sh/api/repos/{owner}/{repo}/remixes`
- Auth: HTTP bearer

Auth required. Pulls the source through the same archive gate, rejects paid/org/private/directory or unspecified-license sources, rewrites manifest provenance, removes eval artifacts, writes a free public local draft with evalStatus unknown, and records a source -> fork graph edge.

## Path parameters

- `owner` string, required
- `repo` string, required

## Request body

- object
  - `name` string
  - `title` string
  - `summary` string
  - `sourceVersion` string
  - `version` string

## Response `201`

Local remix draft created

- object
  - `owner` string, required
  - `repo` string, required
  - `item` RegistryItem, required
    - `owner` string, required
    - `ownerLabel` string
    - `name` string, required
    - `title` string, required
    - `summary` string, required
    - `tags` string[], required
    - `job` string
    - `outcome` string
    - `runtime` string
    - `forgeUrl` string: Public repository or upstream URL when available. Local filesystem paths are never exposed.
    - `contentType` 'harness' | 'directory', required
    - `directory` object
      - `url` string
      - `itemCount` integer
      - `category` string
      - `notes` string
    - `compatibility` object, required
      - `targets` object[], required
        - `id` string
        - `name` string
        - `status` 'planned' | 'available' | 'verified', required
        - `notes` string
        - `last_verified_at` string, date-time
    - `valid` boolean, required
    - `riskScore` number
    - `riskTier` string, required
    - `evalStatus` string, required
    - `evalScore` number
    - `contextCost` ContextCost, required: Deterministic estimate from markdown instruction files. It is not a measured LLM bill.
      - `approxTokens` number, required
      - `files` number, required
      - `bytes` number, required
      - `status` 'estimated', required
    - `standard` 'conformant' | 'partial', required
    - `stars` number
    - `forks` number
    - `threads` number
    - `runs` number
    - `installConfirms` number
    - `signalCount` number
    - `heatQualified` boolean
    - `heat` number
    - `heatDelta` number
    - `freshness` string
    - `badge` string
    - `cliCommand` string, required
    - `updatedAt` string
  - `snapshotVersion` string
  - `verified` boolean, required
  - `remix` object, required
    - `owner` string, required
    - `name` string, required
    - `source` object, required
      - `owner` string, required
      - `repo` string, required
      - `version` string, required
    - `forkGraph` object, required
      - `recorded` boolean, required
      - `source` object, required
        - `owner` string, required
        - `repo` string, required
        - `version` string, required
      - `fork` object, required
        - `owner` string, required
        - `repo` string, required
        - `version` string

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `402`: Payment required before reading paid source files
- `403`: Authorization was provided but is not allowed for this action
- `404`: Resource not found
- `409`: Bad request
- `422`: Bad request

---

[API](https://skmtc.dev/superskill/apis/superskill-api.md) · [All operations](https://skmtc.dev/superskill/apis/superskill-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superskill/apis/superskill-api/revisions/ced2d2d1f217?raw)