humanerd-drew/opencode-drewgent/webhook-subscriptions
Claude Code and agent skill by humanerd-drew/opencode-drewgent
- community
Checking that the SKILL.md file is still in the repository.
Manage webhook subscriptions — register, verify, rotate, and monitor webhook endpoints for external service integrations.
Install
npx vskill@latest install humanerd-drew/opencode-drewgent/webhook-subscriptionsSKILL.md
The same SKILL.md was published earlier as humanerd-drew/opencode-drewgent/webhook-subscriptions.
Webhook Subscriptions
Create dynamic webhook subscriptions so external services (GitHub, GitLab, Stripe, CI/CD, IoT sensors, monitoring tools) can trigger {{AGENT_NAME}} agent runs by POSTing events to a URL.
Setup (Required First)
The webhook platform must be enabled before subscriptions can be created. Check with:
If it says "Webhook platform is not enabled", set it up:
Option 1: Setup wizard
Follow the prompts to enable webhooks, set the port, and set a global HMAC secret.
Option 2: Manual config
Add to ~/.{{AGENT_NAME_LOWER}}/config.yaml:
Option 3: Environment variables
Add to ~/.{{AGENT_NAME_LOWER}}/.env:
After configuration, start (or restart) the gateway:
Verify it's running:
Commands
All management is via the {{AGENT_NAME_LOWER}} webhook` CLI command:
Create a subscription
Returns the webhook URL and HMAC secret. The user configures their service to POST to that URL.
List subscriptions
Remove a subscription
Test a subscription
Prompt Templates
Prompts support {dot.notation} for accessing nested payload fields:
{issue.title}— GitHub issue title{pull_request.user.login}— PR author{data.object.amount}— Stripe payment amount{sensor.temperature}— IoT sensor reading
If no prompt is specified, the full JSON payload is dumped into the agent prompt.
Common Patterns
GitHub: new issues
Then in GitHub repo Settings → Webhooks → Add webhook:
- Payload URL: the returned webhook_url
- Content type: application/json
- Secret: the returned secret
- Events: "Issues"
GitHub: PR reviews
Stripe: payment events
CI/CD: build notifications
Generic monitoring alert
Security
- Each subscription gets an auto-generated HMAC-SHA256 secret (or provide your own with
--secret) - The webhook adapter validates signatures on every incoming POST
- Static routes from config.yaml cannot be overwritten by dynamic subscriptions
- Subscriptions persist to
~/.{{AGENT_NAME_LOWER}}/webhook_subscriptions.json
How It Works
{{AGENT_NAME_LOWER}}webhook subscribewrites to~/.{{AGENT_NAME_LOWER}}/webhook_subscriptions.json`- The webhook adapter hot-reloads this file on each incoming request (mtime-gated, negligible overhead)
- When a POST arrives matching a route, the adapter formats the prompt and triggers an agent run
- The agent's response is delivered to the configured target (Telegram, Discord, GitHub comment, etc.)
Troubleshooting
If webhooks aren't working:
- Is the gateway running? Check with
systemctl --user status {{AGENT_NAME_LOWER}}-gatewayorps aux | grep gateway - Is the webhook server listening?
curl http://localhost:8644/healthshould return{"status": "ok"} - Check gateway logs:
grep webhook ~/.{{AGENT_NAME_LOWER}}/logs/gateway.log | tail -20 - Signature mismatch? Verify the secret in your service matches the one from
{{AGENT_NAME_LOWER}}webhook list. GitHub sendsX-Hub-Signature-256, GitLab sendsX-Gitlab-Token`. - Firewall/NAT? The webhook URL must be reachable from the service. For local development, use a tunnel (ngrok, cloudflared).
- Wrong event type? Check
--eventsfilter matches what the service sends. Use{{AGENT_NAME_LOWER}}webhook test <name>` to verify the route works.
Related
- [[@action/skills/SKILL-INDEX]]
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/devops/webhook-subscriptions/SKILL.md
Popularity
- Repository stars
- 3
- Repository forks
- 8
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/humanerd-drew/opencode-drewgent/webhook-subscriptions)