RouteMux Agent Skills
SKILL.md 파일 몇 개가 코딩 에이전트에게 같은 RouteMux 키로 이미지를 만들고, 영상을 만들고, 모델을 조회하는 법을 알려 줍니다. MIT 라이선스이며, 이 개방형 포맷을 읽는 에이전트라면 어디서든 동작합니다.
왜 필요한가
코딩 에이전트의 base_url을 서드파티 게이트웨이로 돌리면 내장 이미지 도구가 멈춥니다. Codex CLI의 $imagegen이 대표적입니다. 이 도구는 벤더 자신의 구독 세션을 타고 동작하며, 여러분이 설정한 base_url을 보지 않습니다. 설정 오류가 아니고 설정에서 고칠 것도 없습니다. 해법은 이미지 엔드포인트를 평범한 HTTP로 호출하는 스킬을 에이전트에게 주는 것입니다. 그 경로는 영향을 받지 않습니다.
네 가지 스킬
routemux-images
기본 모델은 GPT Image 2.5 Flare입니다. 한 줄 요청을 먼저 자세한 묘사로 풀어 쓴 뒤 이미지를 생성하고, 수정을 요청하면 직전 이미지에서 이어서 고칩니다.
routemux-video
기본은 MiniMax H3 텍스트-영상 생성입니다. 먼저 가격을 알려 주고, 확인하면 작업을 제출하고 기다린 뒤 MP4를 내려받습니다.
routemux-models
이 키로 호출할 수 있는 모델, 가격, 지원하는 기능과 프로토콜을 확인합니다.
routemux-setup
Codex CLI, Claude Code, Cursor, Cline 등 클라이언트를 RouteMux로 연결합니다.
설치
npx skills add https://routemux.com -g/plugin marketplace add https://routemux.com/.well-known/agent-skills/marketplace.json
/plugin install routemux@routemuxcurl -fsSL https://routemux.com/.well-known/agent-skills/install.sh | sh키 설정
Claude Code, Codex, Qwen Code, Gemini CLI가 이미 RouteMux에 연결되어 있다면 스킬이 그 키를 그대로 쓰므로 이 단계는 건너뛰어도 됩니다. 그렇지 않다면 환경 변수 하나를 설정하세요. 설치 스크립트로 설치하면 키를 검증하고 저장해 줍니다. 직접 설정하려면 이 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하세요. 새로 연 터미널부터 적용됩니다.
export ROUTEMUX_API_KEY='sk-...'그다음엔 그냥 말하면 됩니다
에이전트가 routemux-images를 불러와 이 문장을 자세한 이미지 묘사로 풀어 쓰고, GPT Image 2.5 Flare로 이미지를 생성해 파일로 저장합니다.
한 번의 홉으로 접힌 세계 지도를 그려서 ./hop.png 에 저장해 줘무엇을 건드리고, 무엇을 건드리지 않는가
- 키는 ROUTEMUX_API_KEY, 또는 에이전트가 이미 api.routemux.com으로 보내고 있는 키를 씁니다. 후자는 에이전트의 환경 변수나, Codex·Claude Code 설정 파일 중 RouteMux를 가리키는 항목에서 가져옵니다. 다른 곳을 위한 키는 절대 건드리지 않습니다. .env도, 그 밖의 어떤 자격 증명이나 설정 파일도 읽지 않습니다.
- 스킬은 키를 파일·로그·커밋에 절대 쓰지 않습니다. 디스크에 쓰는 것은 여러분이 요청한 결과물뿐이며, 여러분이 준 경로에만 씁니다. 설치 스크립트는 여러분이 동의한 경우에만 키를 shell 설정 파일에 저장합니다.
- eval 없음, SDK 설치 없음 — curl과 약간의 python3뿐입니다. 모든 스크립트는 한 번에 읽을 수 있을 만큼 짧고, 실제로 읽어 보시길 권합니다.