skills.md
Sign in

Quickstart

Install the public CLI and sign in. skills.md is the CLI's default server, so there is no API URL or profile to configure.

Install and sign in

Install
bun install -g @hasna/skills
Sign in
skills login

skills login connects this machine to your skills.md account and creates the account on first sign-in. New accounts start with trial credits.

Check identity
skills whoami

Inspect and quote a hosted skill

The hosted catalog reports availability. blog-article is the initial reviewed paid skill; other entries may be unavailable for hosted execution.

Hosted catalog
skills list --remote --json
Quote
skills quote --json blog-article --topic "Your article topic"

Approve and inspect the result

--yes approves the server's current quote as a credit ceiling. Keep CLI flags before the skill name. Reuse this idempotency key only for the same input.

Run
skills run --remote --yes --wait --json --idempotency-key article-001 blog-article --topic "Your article topic"

Read skills runs status <run-id> --json, then download with skills exports download <run-id> --json. The client verifies artifact size and SHA-256 metadata before creating files.

Add credits

Unused purchased credits expire 365 days after successful payment. Each pack keeps its own expiry date; buying another pack does not extend existing credits.

Available packs
skills credits packs --json

Use skills credits buy <pack-id> --json with an ID from that list. Open the returned checkout link and complete payment yourself. Verify the resulting balance with skills billing status --json; a checkout link alone does not prove payment or credit delivery.

Self-hosted servers

Point the CLI at your own server when you sign in:

Self-hosted sign in
skills login --url https://<your-host>

See Self-hosting for running the server.