CtrlK
BlogDocsLog inGet started
Tessl Logo

granola-webhooks-events

Build event-driven automations with Granola's Zapier webhook triggers. Use when creating real-time notification systems, processing meeting events, or building custom integrations that react to Granola note creation. Trigger: "granola webhooks", "granola events", "granola triggers", "granola real-time", "granola event-driven".

64

Quality

77%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/granola-pack/skills/granola-webhooks-events/SKILL.md
SKILL.md
Quality
Evals
Security

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 (Granola Zapier webhook integrations) and provides explicit trigger guidance. The 'Use when' clause and listed trigger terms make it easy for Claude to select appropriately. The main weakness is that the specific capabilities could be more concrete—listing actual operations rather than high-level categories of use cases.

Suggestions

Add more concrete specific actions such as 'configure webhook endpoints, parse meeting note payloads, set up Zap workflows, handle note creation events' to improve specificity beyond high-level categories.

DimensionReasoningScore

Specificity

Names the domain (Granola Zapier webhook triggers) and some actions (event-driven automations, real-time notification systems, processing meeting events, custom integrations), but the actions are somewhat high-level rather than listing multiple concrete specific operations like 'configure webhook endpoints, parse meeting payloads, set up Zap workflows'.

2 / 3

Completeness

Clearly answers both 'what' (build event-driven automations with Granola's Zapier webhook triggers) and 'when' (creating real-time notification systems, processing meeting events, building custom integrations reacting to Granola note creation), with an explicit 'Use when' clause and explicit trigger terms.

3 / 3

Trigger Term Quality

Includes a good set of natural trigger terms explicitly listed: 'granola webhooks', 'granola events', 'granola triggers', 'granola real-time', 'granola event-driven'. Also includes contextual terms like 'Zapier', 'webhook', 'notification systems', and 'meeting events' that users would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Granola + Zapier + webhooks + event-driven. The combination of product name (Granola) with specific integration mechanism (Zapier webhooks) makes it very unlikely to conflict with other 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 is a solid, actionable skill with concrete code examples and a clear event model explanation. Its main weaknesses are verbosity from duplicated code examples (two languages for the same handler), lack of explicit validation/testing checkpoints in the workflow, and a monolithic structure that would benefit from splitting detailed implementations into separate referenced files.

Suggestions

Add explicit validation checkpoints: e.g., 'Step 3a: Test trigger by moving a note to the folder and confirming Zapier shows the event in Task History before proceeding to build custom handlers.'

Choose one language for the webhook handler (e.g., Express.js) and reference a separate file for the alternative (e.g., 'For Python FastAPI equivalent, see webhook-handler-python.md').

Split the detailed code examples and error handling table into a bundle file (e.g., WEBHOOK_HANDLERS.md) and keep SKILL.md as a concise overview with references.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but includes some unnecessary verbosity. The dual code examples (Express.js AND FastAPI) for the same concept are redundant—one would suffice with a note about language alternatives. The processing patterns table and some explanatory text could be tightened. However, it doesn't over-explain basic concepts.

2 / 3

Actionability

The skill provides fully executable code examples (Express.js handler, FastAPI handler), concrete Zapier configuration in YAML, specific JSON payload structures, and actionable filter patterns. The code is copy-paste ready with realistic field names and routing logic.

3 / 3

Workflow Clarity

Steps are clearly sequenced from understanding the event model through building handlers and error handling. However, there are no explicit validation checkpoints—for instance, no step to verify the Zapier trigger is actually firing before building the custom handler, and no 'test your webhook endpoint' verification step before going live. For a webhook integration involving potential data loss or missed events, this is a gap.

2 / 3

Progressive Disclosure

The content is well-organized with clear sections and tables, but it's monolithic—everything is inline in a single file with no bundle files to offload the detailed code examples or payload reference. The Express.js and FastAPI handlers, error handling patterns, and processing patterns could be split into referenced files. The single reference to 'granola-performance-tuning' at the end is appropriate but the main content is too long for a single SKILL.md.

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.