CtrlK
BlogDocsLog inGet started
Tessl Logo

granola-rate-limits

Understand Granola plan limits, usage quotas, and API rate limiting. Use when hitting meeting limits, choosing between plans, or managing Enterprise API rate limits. Trigger: "granola limits", "granola quota", "granola plan", "granola usage", "granola restrictions".

59

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/granola-pack/skills/granola-rate-limits/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 solid skill description that clearly defines its niche around Granola plan limits and quotas. It includes explicit 'Use when' guidance and well-chosen trigger terms. The main weakness is that the 'what' portion is somewhat informational ('Understand') rather than listing concrete actions the skill enables.

Suggestions

Replace the vague 'Understand' with more specific actions like 'Compare Granola plan tiers, check meeting quotas, troubleshoot rate limit errors, and recommend plan upgrades.'

DimensionReasoningScore

Specificity

The description names the domain (Granola plan limits, usage quotas, API rate limiting) and some actions ('Understand', 'choosing between plans', 'managing Enterprise API rate limits'), but it doesn't list multiple concrete actions—it's more about understanding/consulting information than performing specific operations.

2 / 3

Completeness

The description clearly answers both 'what' (understand Granola plan limits, usage quotas, and API rate limiting) and 'when' (hitting meeting limits, choosing between plans, managing Enterprise API rate limits), with an explicit 'Use when' clause and trigger terms.

3 / 3

Trigger Term Quality

The description includes explicit trigger terms like 'granola limits', 'granola quota', 'granola plan', 'granola usage', 'granola restrictions', plus natural phrases like 'meeting limits', 'choosing between plans', and 'API rate limits'. These cover a good range of terms users would naturally say.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Granola's plan limits and quotas, with product-specific trigger terms that are unlikely to conflict with other skills. The niche is clearly defined around Granola's pricing/plan/quota domain.

3 / 3

Total

11

/

12

Passed

Implementation

50%

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 reference document for Granola plan limits and quotas, well-organized with tables and clear sections. Its main weaknesses are that it leans heavily toward informational content rather than actionable guidance (especially around API rate limiting implementation), and the comprehensive plan feature listings add bulk beyond the skill's core purpose of understanding limits and quotas. The content would benefit from trimming non-limit-related plan features and adding concrete retry/backoff code examples.

Suggestions

Trim plan comparison tables to only limit-relevant features (meeting caps, API access, retention policies) rather than listing every feature like integrations and support tiers.

Add a concrete code example for exponential backoff when handling 429 responses, since the skill recommends it but doesn't show how to implement it.

Move the full plan comparison tables to a separate reference file (e.g., PLAN_DETAILS.md) and keep SKILL.md focused on limits, quotas, and rate limiting behavior.

DimensionReasoningScore

Conciseness

The content is reasonably well-organized with tables, but includes some unnecessary verbosity. The plan comparison tables are quite exhaustive with features Claude could infer or that aren't directly relevant to 'limits and quotas' (e.g., listing every integration). The billing details section and some table rows add bulk without being core to the skill's stated purpose of understanding limits, quotas, and rate limiting.

2 / 3

Actionability

The skill provides a concrete curl command for checking rate limit headers and clear navigation steps for checking usage in the app. However, much of the content is informational/reference rather than actionable — plan comparison tables describe features but don't provide executable guidance. The API rate limiting section lacks concrete implementation examples for exponential backoff despite recommending it.

2 / 3

Workflow Clarity

The 'What Happens at Limits' and 'Error Handling' tables provide clear resolution paths, and the usage monitoring section has a simple step sequence. However, for the API rate limiting workflow — which involves retry logic and is the most operationally complex part — there's no explicit feedback loop or validation checkpoint. The skill mentions exponential backoff but doesn't show how to implement it.

2 / 3

Progressive Disclosure

The content is well-structured with clear headers and tables, and includes external resource links. However, the plan comparison tables are quite long and could be split into a reference file, keeping SKILL.md focused on limits/quotas/rate-limiting behavior. The reference to 'granola-security-basics' as a next step is good, but no bundle files exist to support progressive disclosure.

2 / 3

Total

8

/

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.