instantly-webhooks-events
Implement Instantly.ai webhook event handling with real API v2 event types. Use when setting up webhook endpoints, processing email events, or building CRM sync pipelines from Instantly notifications. Trigger with phrases like "instantly webhook", "instantly events", "instantly webhook handler", "handle instantly events", "instantly notifications".
68
83%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
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 (Instantly.ai webhook handling), provides explicit trigger phrases, and answers both what and when. The main weakness is that the specific capabilities could be more concrete—listing actual actions like parsing specific event types, validating payloads, or mapping to CRM fields would strengthen the specificity dimension.
Suggestions
Add more concrete actions beyond 'processing email events' — e.g., 'parse reply/bounce/open events, validate webhook signatures, map lead data to CRM fields' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (Instantly.ai webhook event handling) and mentions some actions like 'setting up webhook endpoints', 'processing email events', and 'building CRM sync pipelines', but these are more use-case categories than concrete specific actions (e.g., no mention of parsing payloads, validating signatures, mapping fields, etc.). | 2 / 3 |
Completeness | Clearly answers both 'what' (implement Instantly.ai webhook event handling with real API v2 event types) and 'when' (use when setting up webhook endpoints, processing email events, or building CRM sync pipelines), with explicit trigger phrases provided. | 3 / 3 |
Trigger Term Quality | Explicitly lists natural trigger phrases users would say: 'instantly webhook', 'instantly events', 'instantly webhook handler', 'handle instantly events', 'instantly notifications'. Also includes terms like 'CRM sync', 'email events', and 'webhook endpoints' which are natural user language. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific product name 'Instantly.ai' and the combination of webhook handling with that platform. Very unlikely to conflict with generic webhook skills or other CRM-related skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, highly actionable skill with clear workflow sequencing and executable code examples. Its main weakness is length — the extensive handler implementations and comprehensive event type table make it verbose for a SKILL.md that should serve as an overview. The content would benefit from splitting detailed handler patterns into a separate reference file while keeping the core webhook setup flow lean.
Suggestions
Move the detailed event handler implementations (Step 3) into a separate HANDLERS.md reference file, keeping only one example handler inline to demonstrate the pattern.
Trim the prerequisites section — Claude doesn't need to be told what an API key or HTTPS endpoint is; just note the Hypergrowth plan requirement and the env var name.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly comprehensive but includes some unnecessary verbosity. The event types table is useful reference material, but the extensive handler implementations (handleReply, handleBounce, handlePositiveOutcome, etc.) are somewhat over-specified — Claude could infer these patterns from one example. The prerequisites section explains things Claude would know (what an API key is, what HTTPS means). | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code for creating webhooks, handling events, and managing webhook lifecycle. Code examples are concrete with specific API paths, request bodies, and response handling. The error handling table provides specific solutions for specific problems. | 3 / 3 |
Workflow Clarity | The four-step workflow is clearly sequenced (create webhook → build handler → implement handlers → manage webhooks). The handler correctly returns 200 immediately before processing (a critical validation checkpoint), and the error handling table serves as a troubleshooting checklist. The retry behavior (3x in 30s) is explicitly noted where relevant. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections, but it's quite long (~250 lines of code) and monolithic. The detailed handler implementations could be split into a separate reference file. There are no bundle files to offload content to, and the references at the bottom are external links rather than structured internal navigation. The 'Next Steps' reference to 'instantly-performance-tuning' is good but the main content could benefit from splitting. | 2 / 3 |
Total | 10 / 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
70e07c0
- 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.