{"id":51279508,"url":"https://github.com/vavo/runpod-skill","last_synced_at":"2026-06-30T00:32:31.233Z","repository":{"id":356935895,"uuid":"1234369111","full_name":"vavo/runpod-skill","owner":"vavo","description":"A comprehensive Codex skill for Runpod: Serverless workers, Pods, Flash, Public Endpoints, runpodctl, MCP, Python SDK, REST, GraphQL, storage, debugging, and live-doc lookup in one pragmatic workflow.","archived":false,"fork":false,"pushed_at":"2026-05-10T13:48:05.000Z","size":32,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T00:32:30.373Z","etag":null,"topics":["codex","codex-plugin","codex-skill","documentation","runpod","runpod-api","runpod-endpoint","runpod-serverless","skill","skill-md"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vavo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T05:02:30.000Z","updated_at":"2026-06-17T13:09:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vavo/runpod-skill","commit_stats":null,"previous_names":["vavo/runpod-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vavo/runpod-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vavo%2Frunpod-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vavo%2Frunpod-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vavo%2Frunpod-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vavo%2Frunpod-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vavo","download_url":"https://codeload.github.com/vavo/runpod-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vavo%2Frunpod-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34948227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["codex","codex-plugin","codex-skill","documentation","runpod","runpod-api","runpod-endpoint","runpod-serverless","skill","skill-md"],"created_at":"2026-06-30T00:32:30.575Z","updated_at":"2026-06-30T00:32:31.218Z","avatar_url":"https://github.com/vavo.png","language":"Python","funding_links":["https://www.buymeacoffee.com/vavo","https://github.com/sponsors/vavo","https://www.patreon.com/vavo"],"categories":[],"sub_categories":[],"readme":"# Runpod Codex Skill\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-vavo-5F7FFF?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=white)](https://www.buymeacoffee.com/vavo) [![Sponsor on GitHub](https://img.shields.io/badge/Sponsor%20on-GitHub-24292F?style=for-the-badge\u0026logo=github)](https://github.com/sponsors/vavo) [![Support on Patreon](https://img.shields.io/badge/Support%20on-Patreon-FF424D?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://www.patreon.com/vavo)\n\nThe most comprehensive Codex skill set for Runpod yet: one practical skill for working across Serverless, Pods, Flash, Public Endpoints, `runpodctl`, MCP, the Python SDK, REST, GraphQL, storage, deployment, and the small operational traps that usually eat the afternoon.\n\nIt is built for agents that need to do real Runpod work without pretending yesterday's API fields are still gospel.\n\n## What It Covers\n\n- Serverless workers, handlers, endpoint jobs, local testing, Docker packaging, cold starts, logs, model caching, vLLM, and worker fitness checks.\n- Pods, templates, exposed ports, SSH, persistent storage, network volumes, billing/cost guardrails, and `runpodctl` workflows.\n- Flash SDK and CLI workflows, including `runpod_flash`, `Endpoint`, local dev, deployment, app environments, custom containers, and storage.\n- Public Endpoints model APIs for hosted image, video, audio, and text models, with model-page lookup instead of stale hardcoded catalogs.\n- Runpod MCP setup and safe operation notes for Codex-compatible infrastructure management.\n- Python SDK usage for endpoint requests, worker patterns, and API-key handling.\n- REST OpenAPI and GraphQL routing, including the separate GraphQL spec at `https://graphql-spec.runpod.io`.\n- A docs helper script that searches and fetches current Runpod documentation from the official docs index.\n\n## Why This Exists\n\nRunpod has a lot of useful surface area, and most agent guidance covers only one slice: a handler example here, a CLI command there, maybe a Dockerfile if the stars are feeling generous. This skill ties the pieces together so Codex can choose the right tool, refresh the right docs, avoid stale assumptions, and keep live infrastructure changes deliberate.\n\n## Install\n\nCopy the `runpod` skill folder into your Codex skills directory:\n\n```bash\nmkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills\"\nrsync -a runpod/ \"${CODEX_HOME:-$HOME/.codex}/skills/runpod/\"\n```\n\nThen invoke it explicitly:\n\n```text\n$runpod deploy and troubleshoot this Serverless worker\n$runpod check this Dockerfile before I push it to Runpod\n$runpod use Public Endpoints to call the current Flux Dev model\n```\n\n## Repository Layout\n\n```text\nrunpod/\n├── SKILL.md\n├── agents/openai.yaml\n├── references/\n│   ├── doc-map.md\n│   ├── flash.md\n│   ├── graphql.md\n│   ├── pods-cli-api.md\n│   ├── public-endpoints.md\n│   ├── runpodctl.md\n│   └── serverless.md\n└── scripts/\n    └── runpod_docs.py\n```\n\n## Docs-First Workflow\n\nThe skill intentionally avoids baking in fragile tables for GPU names, model catalogs, pricing, API fields, and CLI flags. Instead it points Codex at current official sources and includes a helper:\n\n```bash\npython runpod/scripts/runpod_docs.py search serverless handler\npython runpod/scripts/runpod_docs.py search public endpoints models\npython runpod/scripts/runpod_docs.py page flash/create-endpoints\npython runpod/scripts/runpod_docs.py openapi --output /tmp/runpod-openapi.json\n```\n\nLess stale magic. Fewer expensive surprises.\n\n## Validate\n\nFrom a machine that has the Codex skill-creator tools available:\n\n```bash\nuv run --with pyyaml python /path/to/skill-creator/scripts/quick_validate.py runpod\n```\n\nThe local build of this skill validated successfully with `quick_validate.py`.\n\n## 📜 License\nMIT License - go wild, make cool stuff, just don't blame us if your AI starts writing poetry about toast.\n\nMade with ❤️ and way too much coffee by vavo\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvavo%2Frunpod-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvavo%2Frunpod-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvavo%2Frunpod-skill/lists"}