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
73%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/granola-pack/skills/granola-rate-limits/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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 | |
3e83543
Table of Contents
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.