CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

discord-webhooks

Receive and verify Discord webhook events. Use when setting up Discord webhook handlers, debugging Ed25519 signature verification, handling PING endpoint validation, or processing events like APPLICATION_AUTHORIZED, ENTITLEMENT_CREATE, or LOBBY_MESSAGE_CREATE.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable content with two complete executable reference implementations and clearly signaled supporting files. The main costs are token duplication between SKILL.md and references/overview.md, a large promotional footer, and example links that resolve to nothing inside the bundle.

Suggestions

Remove the duplicated "Common Event Types" table and "Top-Level Payload Structure" sections from SKILL.md and point to references/overview.md, which already contains both.

Trim the 11-entry "Related Skills" list and the webhook-handler-patterns link list to the few most relevant, cutting ~20 lines of promotional tokens.

Fix the examples/express/, examples/nextjs/, and examples/fastapi/ links — either include those directories in the bundle or remove/replace the links, since they currently lead nowhere for a user following them locally.

DimensionReasoningScore

Conciseness

Core sections are code-first and efficient, but the "Common Event Types" table and "Top-Level Payload Structure" duplicate content already in references/overview.md, and roughly 20 lines of "Related Skills" promotional links (11 external repos) pad the token budget. Mostly efficient but could be tightened — the level-3 anchor fits better than level 4 because the duplication and promotional footer go beyond minor trimming.

3 / 5

Actionability

Two complete, copy-paste-ready handlers (Express with discord-interactions and FastAPI with PyNaCl) covering raw-body capture, header checks, Ed25519 verification, PING 204 response, and event dispatch, plus concrete env-var and tunnel commands ("npx hookdeck-cli listen 3000 discord --path /webhooks/discord"). Fully executable and covering the common cases — level 5.

5 / 5

Workflow Clarity

The critical ordering (verify signature before parsing, respond 204 to PING) is explicit in both code examples, and the PING section states that "Endpoint registration fails until your handler does this correctly" — a real checkpoint. However the end-to-end setup sequence (public key → handler → tunnel → portal registration → PING validation) is implicit, scattered across sections rather than sequenced; level 4 with minor validation gaps.

4 / 5

Progressive Disclosure

Three real, clearly labeled, one-level-deep reference files (references/overview.md, setup.md, verification.md) are well signaled in a Reference Materials section with descriptions. Minor gaps: the "examples/express/", "examples/nextjs/", and "examples/fastapi/" links point to directories that do not exist in the bundle, and the event table and payload structure duplicate reference content inline. Good structure overall — level 4 rather than 5 because of the broken example paths and inline duplication.

4 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete, and explicit about both capability and triggers. The only weakness is that a few natural user phrasings (e.g. the "invalid request signature" registration error, Interactions endpoints sharing the scheme) are not included as triggers.

Suggestions

Add the user-facing error phrase "invalid request signature" as a trigger, since developers debugging endpoint registration failure often describe the problem that way.

Mention that Discord Interactions endpoints use the same Ed25519 signing scheme, so users asking about interaction verification also find this skill.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Receive and verify Discord webhook events", "debugging Ed25519 signature verification", "handling PING endpoint validation", "processing events like APPLICATION_AUTHORIZED, ENTITLEMENT_CREATE, or LOBBY_MESSAGE_CREATE" — with comprehensive coverage of the skill's domain. It exceeds the level-4 anchor because there are no minor gaps in the action inventory for this domain.

5 / 5

Completeness

Explicitly answers both questions: the "what" is "Receive and verify Discord webhook events" (third person) and the "when" is an explicit "Use when setting up Discord webhook handlers, debugging Ed25519 signature verification, handling PING endpoint validation, or processing events..." with concrete trigger phrases. Matches the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("Discord webhook handlers", "signature verification", "PING endpoint validation", concrete event names), but a few natural user phrasings are missing — e.g. the "invalid request signature" error the body explicitly targets, generic "Discord events" phrasing, or the Interactions-endpoint synonym for the same signing scheme. Not level 5 because synonym/variation coverage is not comprehensive.

4 / 5

Distinctiveness Conflict Risk

"Discord" plus provider-specific event names (APPLICATION_AUTHORIZED, ENTITLEMENT_CREATE) form a clear niche with distinct triggers; it would not fire for sibling provider webhook skills (Stripe, Shopify, GitHub). Minimal conflict risk — level 5.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository

hookdeck/webhook-skills

Path

skills/discord-webhooks/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.