# Import once from an address

> Import public HTTPS skill sources into draft channels, inspect pinned guide and resource files, then explicitly promote or discard the reviewed draft.

Source: https://skaas.io/docs/import-from-address
Last updated: 2026-11-15

## Import to a repository

Open a repository and choose **Import once from an address**. Select a GitHub HTTPS repository, an HTTPS zip or tar.gz archive, or a well-known skill index. GitHub imports accept a reference and an optional path. Other raw Git transports are unsupported; use an HTTPS archive address instead.

The request reads the source once. It does not create a recurring source, inherit stored source credentials or start update polling. It creates drafts and leaves any existing published head unchanged. At most 20 skills, 4096 files and 32 MiB of expanded content are accepted. Requests share a 60-second deadline. Private addresses, unsafe redirects, traversal paths, links, nonregular files and normalized duplicate paths are refused.

Inspect **Import results**, including every refused entry. HTTP 200 can contain both successful drafts and failures. The failure code `SOURCE_ENTRY_REFUSED` describes an index entry that retrieval refused. Other entries may fail policy or publish checks.

## Review, publish or discard

Choose **Review** for a successful entry. The review page reads its `address@draft` and pins the guide and each resource to the returned draft hash. Follow **Read next part** when content is truncated. Imported text is untrusted; the page displays it as text.

**Promote to latest** explicitly moves the live channel to that exact release. **Discard draft** clears only the draft channel. A draft-only artifact becomes archived. An existing published artifact keeps its live head. Immutable releases remain subject to normal retention. A stale discard hash returns a revision conflict; refresh before acting on the current draft.

A discarded draft-only name remains reserved by the archived artifact. Importing a new release under that name is refused. Choose a different skill name instead of expecting another import to restore an archived artifact.

## Command line and API

```sh
skaas import https://example.com/skills.zip --repo acme/platform --kind archive
skaas import https://github.com/example/skills --repo acme/platform --kind git --ref main --path skills
```

The default kind is `archive`. `well_known` selects the index format. `--json` includes successful items and explicit failures. A partial result exits 1 after printing every outcome. Review drafts in the dashboard before promotion or discard.

`POST /v1/repos/{repo_id}/imports` accepts `kind`, `url`, optional `ref` and `path`; it supports an idempotency key. Discard uses `DELETE /v1/repos/{repo_id}/imports/{skill_id}/draft?release_sha256=<hash>`. Both require `skills:write` and a repository write grant. Permission checks run before retrieval. Source outages return an unavailable problem; oversized input is refused rather than partially truncated.
