Premium Runs

Premium skills run remotely because they may need paid models, hosted workers, storage, or longer-running jobs. The user sees the product contract and the price, not the internal provider routing.

Lifecycle

1. Create a quote.
2. Confirm the run.
3. Poll status or let the agent wait asynchronously.
4. Download artifacts.
5. Store receipt and run metadata.

skills quote logo-design --prompt "mark for a developer tools startup"

skills run logo-design --prompt "mark for a developer tools startup"

Artifact layout

Each run gets its own folder:

.skills/
  exports/
    logo-design/
      run_01hy...
        manifest.json
        receipt.json
        logo.svg
        logo.png

Async status

Long jobs should be resumable by run id.

skills runs status run_01hy...