Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The core technical content is excellent: complete executable verification code with thoughtful handling of the undocumented timestamp unit, a clean event envelope description, and well-signaled reference files. The main weaknesses are non-essential tail sections that spend tokens on cross-promotion rather than the task, and example links pointing at paths missing from the bundle.
Suggestions
Trim the cross-promotional tail: cut the 10-item 'Related Skills' list to 1-2 most-relevant entries and drop or compress the 'Attribution' section, which add ~25 lines without aiding the webhook task.
Remove the 'When to Use This Skill' section, which restates the frontmatter description and spends tokens on content Claude already receives at trigger time.
Fix or remove the dangling examples/express/, examples/nextjs/, and examples/fastapi/ links, since those directories are absent from the bundle — replace with a note that full handlers live in the upstream repository.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core sections (Verification, Event Payload Structure, Event Types) are tight and avoid explaining concepts Claude already knows, but the body carries unnecessary padding: a 10-item "Related Skills" link list, an "Attribution" section, and a "When to Use This Skill" section that duplicates the frontmatter description. This is more than the 'minor instances that could be trimmed' of the 4 anchor, though not the pervasive padding of a 2. | 3 / 5 |
Actionability | The verification section is fully executable, copy-paste-ready JavaScript with unit normalization, stale-delivery rejection, timing-safe comparison, and a length-mismatch guard, plus a concrete env var and a runnable hookdeck-cli tunnel command. It matches the 'fully executable, covers common cases' top anchor rather than the 4 anchor's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The body lays out a coherent implicit sequence (configure secret via env var -> tunnel for local dev -> verify -> dispatch on top-level `type`), and the code embeds validation checkpoints (staleness rejection, false-on-parse-failure). It is not a 5 because the full handler workflow (verify, parse, respond, idempotency) is deferred to an external skill and no guidance is given on responding to failed verification. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview with three real one-level-deep references (references/overview.md, setup.md, verification.md) well-signaled in a 'Reference Materials' section. It is not a 5 because the body links to examples/express/, examples/nextjs/, and examples/fastapi/ directories that are not present in the bundle, so those navigation paths dangle. | 4 / 5 |
Total | 16 / 20 Passed |