watcher-creator

Generates watcher.toml, clients.json entries, and CLI commands for agent-deck watcher setup.

827|144|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/asheshgoplani/agent-deck --skill watcher-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watcher-creator
Source: https://github.com/asheshgoplani/agent-deck/tree/main/cmd/agent-deck/assets/skills/watcher-creator
Command: npx skills add https://github.com/asheshgoplani/agent-deck --skill watcher-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configuring an agent-deck watcher requires knowing adapter-specific settings, correct clients.json sender key formats, and the exact CLI syntax, which is error-prone when done by hand. This Skill walks you through the setup conversationally and produces ready-to-use configuration files and commands.

Core Features & Use Cases

  • Five adapter types supported: webhook, ntfy, github, slack, and gmail, each with documented required and optional settings.
  • Guided configuration generation: Produces a watcher.toml block, a correctly keyed clients.json entry, and the exact agent-deck watcher create command for your chosen adapter.
  • Validation checklist: Verifies name format, port availability, conductor session existence, and sender key formatting before emitting commands.
  • Use Case: You want GitHub pull request events routed to your conductor session. The Skill asks for a name, port, webhook secret, conductor, and group, then outputs the TOML config, the clients.json entry keyed by your GitHub username, and the create/start commands to run.

Quick Start

Ask the assistant to help you set up a new agent-deck watcher for your chosen source, such as GitHub webhooks or an ntfy topic, and answer its questions about name, conductor, and adapter settings.

Frequently Asked Questions about watcher-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a GitHub webhook watcher in agent-deck?

Choose the github adapter, provide a watcher name, a port (default 18461), and the webhook secret configured in GitHub Settings. The Skill generates watcher.toml, a clients.json entry keyed by your GitHub username, and the command `agent-deck watcher create github --name <name> --secret <secret>`.

What watcher adapter types does agent-deck support?

Agent-deck supports five adapter types: webhook for generic HTTP POST endpoints, ntfy for ntfy.sh topic subscriptions, github for repository webhooks with HMAC-SHA256 verification, slack via a Cloudflare Worker bridge to ntfy, and gmail via Google Cloud Pub/Sub.

How is the clients.json sender key formatted for each watcher type?

The key depends on the adapter: webhook uses the X-Webhook-Sender header value, ntfy uses ntfy:<topic>@<server-host>, github uses <username>@github.com, slack uses slack:<CHANNEL_ID>, and gmail uses the sender's email address.

Does the watcher-creator skill execute the watcher create command?

No. The Skill is read-only by design: it generates the configuration files and emits the exact commands, but you must copy and run `agent-deck watcher create` and `agent-deck watcher start` yourself in the terminal.

What prerequisites are needed for a Gmail watcher in agent-deck?

You need a Google Cloud project with the Gmail API and Pub/Sub API enabled, a Pub/Sub topic and subscription, the Pub/Sub Publisher role granted to the Gmail service account, and OAuth client credentials downloaded as credentials.json before running the create command.