SkillsAdd

quantumnous/skills

newapi

Assistant for newapi (new-api), an open-source unified AI gateway platform (https://github.com/QuantumNous/new-api).

First seen Mar 8, 2026

Installation

$ npx skills add quantumnous/skills --skill newapi
View on skills.sh ↗ GitHub repository ↗

Summary

  • Assistant for newapi (new-api), an open-source unified AI gateway platform (https://github.com/QuantumNous/new-api).
  • Use when the user asks about New API, managing models, groups, balance, or tokens, or securely copying keys, applying them to config files, or using them in commands without exposing secrets.
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 85
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code gemini

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,293 B
  • docs SUMMARY.md 3,976 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1,033 installs

SKILL.md

SKILL: newapi

newapi (new-api) is an open-source unified AI gateway platform. It aggregates multiple model providers behind OpenAI / Claude / Gemini compatible interfaces, and provides model, token, group, and balance management.

Security Guidelines

This skill follows these security guidelines to protect API keys:

  1. Do not expose any sk- key value in chat, files, code, logs, or command arguments. To use keys securely, tell the user to run copy-token (clipboard), apply-token (config file), or exec-token (CLI command).
  2. All New API calls should go through the provided scripts (api.js, copy-key.js, inject-key.js, exec-token.js) rather than using curl, wget, fetch, or other HTTP clients to call New API endpoints directly.
  3. Do not read .env files, environment variables containing credentials, or clipboard contents after copy-key.js.
  4. When working with config files that may contain API keys, use inject-key.js --scan to get a sanitized view rather than reading them directly. Note: scan-config is best-effort and not guaranteed to redact every secret in every format.
  5. After create-token, do not make any follow-up call to retrieve or list the key. Report success and tell the user they can use copy-token <id>, apply-token <id> <file>, or exec-token <id> <command> to securely use the key.
  6. Do not modify the security scripts to disable masking or redirect output.

How to Execute

  1. First invocation only — read ${CLAUDESKILLDIR}/docs/setup.md for configuration, auth headers, and runtime detection.
  2. Match the action from the table below.
  3. Read the corresponding doc file for detailed steps.
  4. If no arguments or unrecognized action, show the help table below.
  5. If the user asks about newapi (what it is, how to use a command, or any API usage question like calling a specific model format) — read ${CLAUDESKILLDIR}/docs/help.md and follow the instructions there.

Actions

Action Description Details
models List available models docs/actions-query.md
groups List user groups docs/actions-query.md
balance Show account balance docs/actions-query.md
tokens List API tokens docs/actions-token.md
create-token Create a new API token docs/actions-token.md
switch-group Change a token's group docs/actions-token.md
copy-token Copy real key to clipboard (never shown) docs/actions-token.md
apply-token Apply token key to a config file securely docs/actions-config.md
exec-token Execute a command with the token key securely substituted docs/actions-exec.md
scan-config Inspect config structure with best-effort secret redaction docs/actions-config.md
help Answer questions about newapi docs/help.md

help (or no arguments) — Show available actions

Action Usage Description
models /newapi models List available models
groups /newapi groups List user groups
balance /newapi balance Show account balance
tokens /newapi tokens List API tokens
create-token /newapi create-token <name> [--group=xxx] Create a new API token
switch-group /newapi switch-group <token_id> <group> Change a token's group
copy-token /newapi copy-token <token_id> Copy real key to clipboard (never shown)
apply-token /newapi apply-token <tokenid> <filepath> Apply token key to a config file securely
exec-token /newapi exec-token <token_id> <command...> Execute a command with the token key securely substituted
scan-config /newapi scan-config <file_path> Inspect config structure with best-effort secret redaction
help /newapi help <question> Answer questions about newapi