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.

By The SKaaS team. Last updated . Markdown version

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

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.