imhansiy/cliproxy-manager
skills/cliproxy-manager/SKILL.md
Unified management skill for CLIProxyAPI, enabling AI to dynamically update service configurations (API Keys, model aliases, proxy rules) and monitor usage statistics.
tools
Updated Apr 28, 2026
$ install --global
skillsauthnpx skillsauth add imhansiy/my-skills cliproxy-managerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 2:23 PM214.1s2 files scanned
SKILL.md
- name:
- cliproxy-manager
- description:
- Unified management skill for CLIProxyAPI, enabling AI to dynamically update service configurations (API Keys, model aliases, proxy rules) and monitor usage statistics.
CLIProxyAPI Manager Skill
This skill grants the AI instance the ability to manage the CLIProxyAPI service remotely or locally. With this skill, the AI can automate configuration processes, modify model routing, and monitor service health.
⚠️ Prerequisites (MANDATORY)
Before executing any API operations, the AI must:
- Confirm Service Status: Check if the CLIProxyAPI process is running (default port
8317). - Obtain Management Key: A valid key must be provided for authentication.
- Check the
MANAGEMENT_PASSWORDenvironment variable. - Search for
remote-management.secret-keyinconfig.yaml. - If the key is hashed (bcrypt), the user must provide the plaintext key or use a temporary key set via the command line (
--password).
- Check the
- Verify Connectivity: Attempt to call
GET /v0/management/configfor an authentication test.
Key Workflows
1. Configuration Management
- View Current Config: Call
GET /configto understand current routing and model providers. - Update Model Aliases or API Keys: Use
PATCHon the corresponding endpoint (e.g.,/claude-api-keyor/openai-compatibility). - Synchronous Updates: All API changes are automatically written back to the disk file; no manual YAML editing is required.
2. Status & Statistics
- Usage Stats: Use
GET /usageto view quotas and request counts for different models or API keys. - Debug Monitoring: Use
GET /debugto retrieve backend connection status.
3. API Reference
| Endpoint | Method | Common Use Case |
| :---------------------- | :---------- | :--------------------------------------------------------------------- |
| /config | GET | Fetch the final global configuration |
| /api-keys | PUT/PATCH | Manage CLIProxyAPI's own access keys |
| /gemini-api-key | PATCH | Rotate or add Gemini keys |
| /claude-api-key | PATCH | Rotate or add Claude keys |
| /openai-compatibility | PATCH | Configure new OpenAI-compatible providers (e.g., DeepSeek, OpenRouter) |
| /usage | GET | View real-time model usage reports |
Scripts
A helper Python script cliproxy_api.py is provided in the <SKILL_PATH>/scripts/ directory to encapsulate authentication logic:
# Example: Fetch all configurations
python <SKILL_PATH>/scripts/cliproxy_api.py --key YOUR_KEY get config
# Example: Update a specific API Key in the config
python <SKILL_PATH>/scripts/cliproxy_api.py --key YOUR_KEY patch api-keys --data '{"old":"k1", "new":"k2"}'
Rules & Best Practices
- Security First: Never log the full management key in any output or logs.
- Transactional Consistency: Always perform
GET /configto verify current state before applying updates. - Backup Recommendation: Before a full configuration overwrite (
PUT), it is recommended to back up the currentGET /configresult to/tmp/.
Related Skills
imhansiy/browserless
tools
VerifiedTrustedCommunity
MUST USE before playwright/dev-browser/local browser tools when any remote Browserless target is configured or when the user mentions Browserless, remote browser, headless Chrome endpoint, screenshots, PDFs, rendered HTML, scraping, dynamic public webpages, browser automation, webpage debugging, clicking/typing page elements, Puppeteer/Playwright sessions, or provides a Browserless URL/token/name. This skill has priority over generic browser skills for public HTTP(S) pages; use remote Browserless first, then fall back to local Playwright/dev-browser only after Browserless health/action failure, unreachable target, or a local/private page that cannot be exposed publicly. Manages Browserless endpoints/tokens and uses the bundled Node.js script for automation.
SKILL.mdUpdated Jun 8, 2026
imhansiy/cliproxyapi-manager-skill
tools
VerifiedTrustedCommunity
Manage CLIProxyAPI or CLIProxyAPIPlus only: save CLIProxyAPI Management API URL and password under the user's home .config/cliproxyapi directory, call every CLIProxyAPI Management API endpoint, manage config/auth files/provider keys/model aliases/logs/usage/OAuth URLs, and work on Windows, Linux, and macOS without opening the web UI.
SKILL.mdUpdated May 3, 2026
imhansiy/plantuml-image-generator
development
VerifiedTrustedCommunity
Triggered when the user requests an image (e.g., architecture, flowchart, sequence diagram) or needs a technical illustration inserted into a document. This skill dynamically generates and inserts images using the official PlantUML public API.
SKILL.mdUpdated Apr 28, 2026
imhansiy/odoorpc-agent-skill
development
VerifiedTrustedCommunity
Use proactively for Odoo work. Connect AI coding agents to Odoo through Python OdooRPC profiles, inspect live records, troubleshoot models, fields, access rights, modules, companies, connectors, imports, synchronization issues, odoo.conf, addons paths, backup restore, filestore checks, and guarded create/update/delete workflows.
SKILL.mdUpdated Apr 28, 2026