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 well-structured skill description that clearly identifies its niche (Instantly.ai webhook handling), provides explicit trigger terms, and answers both what and when questions. The main weakness is that the specific capabilities could be more concrete—listing actual event types or specific processing actions would strengthen the specificity dimension.
Suggestions
Add more concrete actions such as specific event types handled (e.g., 'email_sent', 'reply_received', 'lead_status_changed') to increase specificity beyond the general 'processing email events'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Instantly.ai webhook event handling) and mentions some actions like 'setting up webhook endpoints', 'processing email events', 'building CRM sync pipelines', but these are somewhat general and could be more concrete (e.g., specific event types handled, specific data transformations performed). | 2 / 3 |
Completeness | Clearly answers both 'what' (implement Instantly.ai webhook event handling with real API v2 event types) and 'when' (setting up webhook endpoints, processing email events, building CRM sync pipelines) with explicit trigger phrases listed. | 3 / 3 |
Trigger Term Quality | Explicitly lists natural trigger phrases like 'instantly webhook', 'instantly events', 'instantly webhook handler', 'handle instantly events', 'instantly notifications'. Also includes terms like 'webhook endpoints', 'email events', 'CRM sync pipelines' which users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific to Instantly.ai's webhook API v2, making it very unlikely to conflict with generic webhook skills or other CRM integration skills. The 'Instantly' qualifier creates a clear niche. | 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 practical error handling guidance. Its main weakness is length — the detailed event handler implementations inflate the token cost and could be condensed or split into a separate file. The event types reference table and API endpoints table are valuable quick-reference additions.
Suggestions
Condense Step 3 event handlers to 1-2 representative examples with a comment like '// Similar pattern for other events' — Claude can infer the CRM sync pattern from one example.
Consider extracting the full event handler implementations and the event types table into a separate bundle file (e.g., HANDLERS.md or REFERENCE.md) to reduce the main skill's token footprint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly comprehensive but includes some verbosity — the full event handler implementations (handleReply, handleBounce, handlePositiveOutcome, etc.) are quite lengthy and could be condensed since Claude can infer CRM sync patterns. The event types table is useful but some entries could be trimmed. Overall mostly efficient but could be tightened. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code for creating webhooks, handling events, and managing webhook lifecycle. Code is copy-paste ready with concrete API paths, request bodies, and typed data structures. The error handling table provides specific solutions for specific problems. | 3 / 3 |
Workflow Clarity | Clear 4-step sequence (Create → Handle → Implement → Manage) with explicit validation patterns: secret verification, immediate 200 response before async processing, error handling with try/catch, and webhook health checking via delivery summary endpoints. The error handling table serves as a troubleshooting checklist with feedback loops (fix endpoint → resume webhook). | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and tables, but it's quite long (~250 lines of code) with no bundle files to offload detailed implementations. The event handler implementations (Step 3) could be split into a separate reference file. The 'Next Steps' reference to 'instantly-performance-tuning' is good but the main content is monolithic. | 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
a04d1a2
- 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.