gamma-webhooks-events
Handle Gamma webhooks and events for real-time updates. Use when implementing webhook receivers, processing events, or building real-time Gamma integrations. Trigger with phrases like "gamma webhooks", "gamma events", "gamma notifications", "gamma real-time", "gamma callbacks".
80
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/gamma-pack/skills/gamma-webhooks-events/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description that clearly identifies its niche (Gamma webhooks), provides explicit trigger guidance, and distinguishes itself well from other skills. Its main weakness is that the capability descriptions are somewhat generic—it describes webhook handling in broad terms rather than listing specific concrete actions like payload parsing, signature verification, or handling specific Gamma event types.
Suggestions
Add more specific concrete actions such as 'verify webhook signatures, parse event payloads, handle subscription lifecycle events, retry failed deliveries' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Gamma webhooks/events) and some actions ('implementing webhook receivers', 'processing events', 'building real-time integrations'), but these are fairly generic descriptions of webhook handling rather than listing multiple specific concrete actions like parsing payloads, verifying signatures, or handling specific event types. | 2 / 3 |
Completeness | Clearly answers both 'what' (handle Gamma webhooks and events for real-time updates) and 'when' (explicit 'Use when' clause with trigger scenarios and a 'Trigger with phrases' section listing specific keywords). | 3 / 3 |
Trigger Term Quality | Includes a good set of natural trigger terms: 'gamma webhooks', 'gamma events', 'gamma notifications', 'gamma real-time', 'gamma callbacks'. These cover multiple variations a user might naturally say when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of 'Gamma' as a specific platform with 'webhooks/events' creates a clear niche. The trigger terms are all prefixed with 'gamma', making it unlikely to conflict with generic webhook skills or other platform-specific skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides highly actionable, executable TypeScript code for building event-driven patterns around Gamma's poll-based API. Its main weakness is length—four complete implementation patterns inline makes it heavy for a SKILL.md without supporting bundle files. Adding validation checkpoints between steps and splitting advanced patterns (Bull queue, HTTP callbacks) into separate files would improve both workflow clarity and progressive disclosure.
Suggestions
Split Steps 3 (Bull Queue) and 4 (HTTP Callback) into separate referenced files to reduce SKILL.md size and improve progressive disclosure.
Add explicit validation checkpoints, e.g., 'Test the event emitter with a mock generation before proceeding to Step 2' and 'Verify Redis connectivity before deploying the Bull worker.'
Trim the overview section—Claude doesn't need the explanation of what webhooks are or why Gamma lacks them; a single sentence noting the poll-based pattern suffices.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary verbosity—the overview explaining that Gamma doesn't have webhooks could be shorter, and the event listener examples include placeholder comments (e.g., 'Save to S3, send to user, etc.') and pseudo-DB calls that add bulk. The synthetic event table is useful but the surrounding prose could be tighter. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code across four distinct patterns (EventEmitter, listeners, Bull queue worker, HTTP callback). Code is complete with imports, types, error handling, and concrete configuration values like timeouts and poll intervals. | 3 / 3 |
Workflow Clarity | Steps are clearly numbered and sequenced (1-4), and the polling loop includes timeout handling. However, there are no explicit validation checkpoints between steps—no guidance on verifying the event emitter works before adding listeners, no testing step after setting up the Bull worker, and no feedback loop for verifying the callback endpoint is reachable before relying on it. | 2 / 3 |
Progressive Disclosure | The content references external resources (Gamma API docs, Bull docs) and a next-step skill, but the SKILL.md itself is quite long (~180 lines of code) with all four patterns inline. The Bull queue pattern and HTTP callback pattern could reasonably be split into separate reference files, especially since no bundle files exist to support this structure. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
3a2d27d
- 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.