# Proxy

> Local-first proxy inventory, routing planner, and health tracking engine. Use whenever the user needs to organize proxy assets, compare providers, track regions, protocols, auth methods, manage expiry, assign sessions, or decide which proxy best fits a task. Stores all data locally only.

- Skill: `dvcrn/proxy` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add dvcrn/proxy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/proxy/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/proxy

---


# Proxy

Know what you have. Route with intention.

## Core Philosophy
1. Treat proxies as infrastructure assets, not throwaway strings.
2. Recommendation quality matters more than raw inventory size.
3. Track health, expiry, and fit-for-purpose before choosing a proxy.
4. Keep all proxy metadata local-only.

## Runtime Requirements
- Python 3 must be available as `python3`
- No external packages required

## Storage
All data is stored locally only under:
- `~/.openclaw/workspace/memory/proxy/proxies.json`
- `~/.openclaw/workspace/memory/proxy/sessions.json`
- `~/.openclaw/workspace/memory/proxy/stats.json`

No external sync. No cloud storage. No third-party proxy APIs required.

## What This Skill Manages
- provider
- host and port
- protocol
- region / country / city
- auth type
- sticky or rotating behavior
- session labels
- status and health notes
- expiry date
- cost and quality metadata

## Key Workflows
- **Add Proxy**: `add_proxy.py` to record a proxy and its metadata
- **List Inventory**: `list_proxies.py` to view and filter available proxies
- **Pick Best Fit**: `pick_proxy.py` to recommend the best proxy for a given use case
- **Score Quality**: `score_proxy.py` to update health, reliability, and fit
- **Update Metadata**: `update_proxy.py` to change status, expiry, notes, or tags

## Scripts
| Script | Purpose |
|---|---|
| `init_storage.py` | Initialize local storage files |
| `add_proxy.py` | Add a proxy asset |
| `list_proxies.py` | List and filter proxies |
| `score_proxy.py` | Score reliability and quality |
| `pick_proxy.py` | Recommend the best proxy for a task |
| `update_proxy.py` | Update status, expiry, notes, or tags |