skills.mdPricing
skills.md exposes user-visible pricing before paid work starts. Free skills stay free; premium skills quote a fixed or input-based dollar amount.
Pricing model
| Type | Behavior |
|---|---|
| Free local skills | No balance check and no paid run receipt. |
| Premium fixed-price skills | One clear price per run. |
| Premium variable skills | Price depends on user-visible units such as articles, pages, or generated assets. |
| Subscriptions | Unlock product features and may coexist with pay-per-use runs. |
Quote fixed-price work
skills quote landing-page-pack --product "AI billing dashboard"Quote variable work
skills quote blog-article --topic "SOC 2 for startups" --articles 12User-facing quote
A quote should include:
- Skill name.
- Price in dollars.
- Input units that affected the price.
- Approval requirement.
- Expiration or idempotency key when available.
Balance and receipt flow
Quote
The CLI, MCP, or web app asks the API for a public quote.
Approve
The user approves the dollar amount for paid work.
Deduct
The server reserves or deducts balance before the run enters the queue.
Refund on failure
If the run fails before producing usable output, the server records a refund transaction.
Write receipt
The run exports include receipt metadata alongside the manifest.
Current premium examples
| Skill | Example price behavior |
|---|---|
blog-article | Priced per generated article. |
seo-content-pack | Fixed package price. |
landing-page-pack | Fixed package price. |
ad-creative-pack | Fixed package price. |
email-sequence | Fixed package price. |
pdf-to-markdown | Fixed document-processing price. |