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
70%
Does it follow best practices?
Impact
—
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 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.'
| 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—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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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 | |
d41e58e
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.