| name | altllm-portal-cli |
| description | Use this umbrella skill when the request spans multiple AltLLM Portal CLI domains, or when you need to navigate the local altllm CLI in this repository across auth, API keys, billing history, NOWPayments payment links, and related x402 Portal top-up guidance. |
| user-invocable | true |
AltLLM Portal CLI
Use this umbrella skill when working inside this repository and the task crosses multiple Portal domains. For focused requests, prefer one of the domain skills below.
AltLLM itself has two distinct surfaces that are easy to confuse:
- the Portal API, which manages auth, billing, API keys, and payment links
- the OpenAI-compatible gateway, which consumes Portal-issued API keys for model inference
This skill family is specifically about the Portal CLI workflow in this repository. Use it to operate the Portal side safely and consistently, not to document or proxy the gateway itself.
Shared Setup
Before the first altllm command in a fresh checkout, read and follow:
../_shared/preflight.md
../_shared/session-and-target.md
Skill Map
| Skill | Purpose | Use When |
|---|
altllm-portal-auth | Wallet login and session bootstrap | Wallet challenge, signature verification, login troubleshooting |
altllm-portal-api-keys | Portal API key lifecycle | Create, inspect, disable, re-enable, or revoke API keys |
altllm-portal-billing | Balance, promo, transactions, and usage analytics | Credit balance, promo redemption, billing history, usage views |
altllm-portal-payments | NOWPayments link creation, polling, and direct payment execution | Crypto top-up links, payment status, direct wallet payment |
altllm-x402 | Portal x402 credit top-up guidance | BSC/USDT x402 quotes, discount top-ups, wallet signing, settlement, facilitator errors |
Plan Awareness
- Personal tiers are
free, basic, pro, and power; Business/Flex is flex.
- Use
credit to inspect plan/model-access metadata returned by Portal, including subscription_tier: "flex" when present.
- Flex users can create API key allowlists with normal AltLLM model IDs and Flex-only
altllm-flex-* IDs, subject to backend access checks.
Working Rules
- Prefer the focused skill when the request stays within one domain.
- Use this umbrella skill when the workflow spans multiple domains, for example:
- login -> create API key -> verify gateway use
- credit -> transactions -> usage analytics
- top-up -> payment-status -> pay-payment-link
- x402 quote -> wallet signing -> settlement -> balance verification
- Keep implementation and docs aligned when behavior changes.
Reference
See references/skill-map.md for file ownership and command-to-skill mapping.