Sub2API Admin

What it does

When your agent uses it

• Listing or inspecting accounts on a Sub2API instance
• Creating or revoking redeem and invitation codes
• Bulk importing, exporting or refreshing accounts
• Clearing account errors or adjusting proxies and groups

Example prompts

• “List all Sub2API accounts that are currently in an error state.”
• “Create ten recharge codes for the trial group.”
• “Export the accounts in group 3 to a file, without printing them.”

Requirements

• A Sub2API instance URL
• An admin API key or admin JWT
• Node.js to run scripts/sub2api-admin.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Reuse SUB2API_BASE_URL and either SUB2API_ADMIN_API_KEY or SUB2API_JWT from the environment.
2. 2Run read-only commands first: accounts list, accounts get , groups all, or proxies all.
3. 3Before destructive or bulk writes, print the target account names and IDs.
4. 4Execute the write command only after the target set is clear.
5. 5Run a follow-up read command to verify the result.

What it can do on your machine

Read from SKILL.md and the folder at commit 3f1a2ea. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (JavaScript), which the agent can run.

  Shell commands in SKILL.md call:

  • node

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • SUB2API_ADMIN_API_KEY
  • INVALID_ADMIN_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sub2API Admin loads about 717 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 124 tokens; SKILL.md has 177 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~124

When it runs · the whole SKILL.md, loaded when a task matches

~717

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Wei-Shaw/sub2api at commit 3f1a2ea, republished under its LGPL-3.0 licence (© Wei-Shaw). 177 words, ~717 tokens.

name

sub2api-admin

description

Manage Sub2API admin APIs for accounts, redeem codes, groups, proxies, error passthrough rules, TLS fingerprint profiles, imports, exports, batch updates, and raw administrator API calls. Use when the user mentions Sub2API, admin API keys, account management, redeem code management, recharge codes, invitation codes, bulk account import/export, keeping or deleting accounts, refreshing accounts, clearing errors, CRS sync, or managing Sub2API backend settings through the admin API.

export SUB2API_BASE_URL='https://your-sub2api-host'
export SUB2API_ADMIN_API_KEY='<admin api key>'
# Or, when the deployment uses admin JWT login instead of an admin API key:
# export SUB2API_JWT='<admin access_token>'
node scripts/sub2api-admin.js accounts list

node scripts/sub2api-admin.js accounts list --page-size 20
node scripts/sub2api-admin.js accounts get 40
node scripts/sub2api-admin.js accounts usage 40
node scripts/sub2api-admin.js accounts set-schedulable 40 true
node scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10}'
node scripts/sub2api-admin.js redeem-codes list --page-size 20
node scripts/sub2api-admin.js redeem-codes generate --json '{"count":1,"type":"balance","value":10}' --idempotency-key redeem-$(date +%s)
node scripts/sub2api-admin.js redeem-codes create-and-redeem --json '{"code":"order_123","type":"balance","value":10,"user_id":123}' --idempotency-key order-123
node scripts/sub2api-admin.js error-rules list
node scripts/sub2api-admin.js tls-profiles list

© Wei-Shaw, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/sub2api-admin of Wei-Shaw/sub2api.

• SKILL.md
• agents/openai.yaml
• references/admin-cli.md
• scripts/sub2api-admin.js

Open the folder on GitHubat commit 3f1a2ea

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Wei-Shaw/sub2api, which our catalogue first saw on October 7, 2026.

• MACOS-DO/sub4apiskills/sub2api-admin