omni-webhooks — Claude Code skill for webhook management
Manage OmniRoute webhook endpoints, event subscriptions and delivery retries. Use it when you need to create, test or remove a webhook through the API.
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-codeWhat omni-webhooks does
This skill manages OmniRoute webhooks through its API. It can list endpoints, retrieve one by ID, create or update a record, remove it, and trigger a test delivery.
It handles subscriptions for events such as request.completed, request.failed, and quota.exceeded. It can also inspect endpoint deliveries and validate an address before saving it. Request and response schemas are available through GET /api/openapi/spec and docs/openapi.yaml.
Every request needs a valid Bearer token or session cookie. Local development can use REQUIRE_API_KEY=false, so check authentication settings before testing a delivery.
What it helps with
- register a webhook endpoint
- subscribe an endpoint to
request.failed - validate a webhook address before saving
- trigger a test delivery
- inspect deliveries for an endpoint
Example prompts for the agent
- “Create an OmniRoute webhook and subscribe it to `request.completed`.”
- “Validate this webhook address before saving it.”
- “Run a test delivery for webhook `<id>` and show its delivery history.”
How to install omni-webhooks
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-code2Manually: put the files in place
~/.claude/skills/omni-webhooks/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/omni-webhooks/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a codex2Manually: put the files in place
.agents/skills/omni-webhooks/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a cursor2Manually: put the files in place
.cursor/skills/omni-webhooks/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute omni-webhooks2Manually: put the files in place
.github/skills/omni-webhooks/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/omni-webhooksManually: put the files in place
.devin/skills/omni-webhooks/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about omni-webhooks
How do I install omni-webhooks in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill omni-webhooks -a claude-code. The skill is installed at ~/.claude/skills/omni-webhooks/SKILL.md.
What does omni-webhooks do?
It manages OmniRoute webhook endpoints: creating, listing, updating, testing, and removing them. It also configures event subscriptions and delivery handling.
What does omni-webhooks need to make requests?
Requests require a valid Bearer token or a session cookie. For local development, REQUIRE_API_KEY=false can be configured.
Source text
SKILL.md · MIT
---
name: omni-webhooks
description: Register, list, test, and remove webhook endpoints. Configure event subscriptions (request.completed, request.failed, quota.exceeded, etc.) and manage delivery retries.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
## Overview
Register, list, test, and remove webhook endpoints. Configure event subscriptions (request.completed, request.failed, quota.exceeded, etc.) and manage delivery retries.
## Authentication
All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.
## Endpoints
### GET /api/webhooks
GET webhooks
```bash
curl http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### POST /api/webhooks
POST webhooks
```bash
curl -X POST http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### GET /api/webhooks/{id}
GET webhooks › <id>
```bash
curl http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### PUT /api/webhooks/{id}
PUT webhooks › <id>
```bash
curl -X PUT http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### DELETE /api/webhooks/{id}
DELETE webhooks › <id>
```bash
curl -X DELETE http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### GET /api/webhooks/{id}/deliveries
GET webhooks › <id> › deliveries
```bash
curl http://localhost:20128/api/webhooks/{id}/deliveries \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### POST /api/webhooks/{id}/test
POST webhooks › <id> › test
```bash
curl -X POST http://localhost:20128/api/webhooks/{id}/test \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### POST /api/webhooks/validate-url
POST webhooks › validate url
```bash
curl -X POST http://localhost:20128/api/webhooks/validate-url \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
## Payloads
See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.
© cheaper-inference · MIT · cheaper-inference/OmniRoute