granola-upgrade-migration
Upgrade Granola app versions and migrate between subscription plans. Use when upgrading the desktop app, changing from free to paid plans, downgrading with data preservation, or resolving update issues. Trigger: "upgrade granola", "granola update", "change granola plan", "granola new version", "granola downgrade".
89
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%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-crafted skill description that clearly identifies the specific product (Granola), lists concrete actions (upgrading, plan migration, downgrading, resolving update issues), and provides explicit trigger guidance with natural user phrases. The description is concise, uses third-person voice, and would be easily distinguishable from other skills in a large collection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: upgrading app versions, migrating between subscription plans, changing from free to paid plans, downgrading with data preservation, and resolving update issues. | 3 / 3 |
Completeness | Clearly answers both 'what' (upgrade app versions, migrate subscription plans) and 'when' (explicit 'Use when...' clause with specific scenarios plus a dedicated 'Trigger:' section with example phrases). | 3 / 3 |
Trigger Term Quality | Includes explicit natural trigger terms that users would actually say: 'upgrade granola', 'granola update', 'change granola plan', 'granola new version', 'granola downgrade'. These cover common variations of how users would phrase their requests. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific product name 'Granola' and the narrow focus on version upgrades and plan migrations for that specific app. Very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%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 clear step-by-step workflows and executable commands. Its main weakness is length—the extensive plan feature lists, migration matrix, and seat management details could be more concise or split into referenced files. The escalating troubleshooting approach and pre-downgrade checklist demonstrate good workflow design.
Suggestions
Move the detailed plan feature comparison and migration matrix into a separate reference file (e.g., PLANS.md) and link to it from the main skill to improve conciseness and progressive disclosure.
Trim the 'Output' section—it restates what the steps already accomplish and adds little actionable value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some unnecessary detail that Claude would know or could infer, such as explaining what each plan tier includes in extensive detail. The plan migration matrix and feature lists are borderline—useful as reference but verbose. Some sections like 'Output' add little value. | 2 / 3 |
Actionability | The skill provides concrete, executable bash commands for version checking, cache clearing, reinstalling, and Homebrew updates. UI navigation paths are specific (e.g., 'Settings (avatar bottom-left) > Account > Subscription > Upgrade'). The pre-downgrade checklist is actionable and specific. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced from checking version through updating, troubleshooting, upgrading plans, downgrading, and managing seats. The troubleshooting section has an escalating approach (clear caches → reset preferences → nuclear reinstall). The pre-downgrade checklist serves as a validation checkpoint before destructive plan changes. | 3 / 3 |
Progressive Disclosure | The content is all inline in a single file with no references to separate detailed documents for things like the full feature comparison or integration setup guides. The Resources section links to external URLs but the skill itself is quite long and could benefit from splitting detailed plan feature lists or troubleshooting into separate files. | 2 / 3 |
Total | 10 / 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 | |
- Commit
c8a915c
- 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.