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".

77

Quality

73%

Does it follow best practices?

Impact

Pending

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 communicates its scope (Granola plan limits and quotas) and provides explicit trigger guidance. Its main weakness is that the 'what' portion uses the vague verb 'Understand' rather than listing concrete actions the skill performs (e.g., compare plans, explain quota thresholds, troubleshoot rate limit errors). The trigger terms and completeness are strong.

Suggestions

Replace the vague 'Understand' with specific concrete actions such as 'Compare Granola plans, explain meeting quotas, troubleshoot API rate limit errors' to improve specificity.

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—'Understand' is vague, and the specifics of what the skill actually does (e.g., compare plans, explain quotas, troubleshoot rate limits) are not enumerated.

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 explicit 'Use when' and 'Trigger' clauses.

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 a user would naturally say.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Granola's plan limits, quotas, and rate limiting, with product-specific trigger terms. It is unlikely to conflict with other skills unless there are multiple Granola-related skills, in which case the focus on limits/quotas/plans provides a clear niche.

3 / 3

Total

11

/

12

Passed

Implementation

57%

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 skill that organizes plan and limit information in scannable tables with clear error resolution paths. Its main weakness is verbosity — the full feature comparison tables could be condensed to focus on differentiating features and limits rather than listing every included feature. The actionability could be improved with concrete code examples for common scenarios like implementing exponential backoff for API rate limits.

Suggestions

Condense plan comparison tables to only show differentiating features and limits rather than listing every included feature across all tiers — Claude can infer that higher tiers include lower-tier features.

Add a concrete exponential backoff implementation example for handling API 429 responses, rather than just mentioning it in the error table.

Remove or significantly trim the Billing Details section — prorated upgrades and annual billing discounts are generic SaaS concepts that don't need explicit documentation for Claude.

DimensionReasoningScore

Conciseness

The content is reasonably well-organized but includes some information that could be trimmed — for example, the full feature lists for each plan tier are quite verbose and include features Claude doesn't need spelled out (e.g., 'Granola Chat: Included' repeated across tiers). The billing details section also contains fairly generic information. However, the tables are a compact format and most content is relevant to the skill's purpose.

2 / 3

Actionability

The skill provides concrete steps for checking usage and a real curl command for monitoring API rate limits, which is good. However, much of the content is informational/reference rather than actionable — plan comparison tables and billing details describe states rather than instruct. The API rate limit section lacks specific implementation examples for exponential backoff.

2 / 3

Workflow Clarity

The 'What Happens at Limits' and 'Error Handling' tables provide clear resolution paths, and the usage checking steps are sequenced. However, the API rate limiting workflow lacks a proper feedback loop — it mentions respecting Retry-After but doesn't provide a concrete retry pattern. For a reference/informational skill this is adequate but not exemplary.

2 / 3

Progressive Disclosure

The content is well-structured with clear sections, uses tables effectively for scannable reference data, links to external resources for deeper dives (pricing page, API docs, changelog), and points to a related skill for security topics. For a reference-style skill, this is appropriately organized without unnecessary nesting.

3 / 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.