[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M792XBXP5AM24KVC6QDXK7W2":3,"skill-same:01M792XBXP5AM24KVC6QDXK7W2":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M792XBXP5AM24KVC6QDXK7W2","upgrade-paths",null,"Convert free to paid in-product: feature gates, upgrade screens, trial-end moments and expansion offers. Use when designing in-app paywalls, upgrade modals, or usage triggers.","poorvith-mp\u002Fskills-marketing","poorvith-mp","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F277478855?v=4","01M78Z5K0YH1Z3PX815PGQ96ND","Poorvith M P","01M792P4C4Z12T0V4B97Z9MNX3",0,"MIT","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fupgrade-paths\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: upgrade-paths\nlast_reviewed: 2026-09-06\ngroup: Lifecycle\ndescription: >-\n  Convert free to paid in-product: feature gates, upgrade screens, trial-end moments and expansion\n  offers. Use when designing in-app paywalls, upgrade modals, or usage triggers.\n---\n\n# upgrade-paths\n\n## Core Philosophy\nFreemium and free trial tiers fail when the upgrade path is invisible, arbitrary, or punitive. The best software upgrades do not feel like an aggressive tollbooth; they feel like a natural, celebrated milestone of business growth. Effective upgrade paths align monetization with the exact moment a customer realizes enterprise scale, mission-critical operational reliance, or collaborative team expansion.\n\n---\n\n## 4-Step Upgrade Path Engineering\n\n### Step 1: Monetization Trigger & Gate Classification\n1. **The 3 Upgrade Trigger Archetypes**:\n   - *Capacity & Usage Limits (Scale Trigger)*:\n     - Free tier covers individual\u002Fhobbyist volume (e.g. 10,000 monthly events, 5GB storage).\n     - Upgrade triggers when volume indicates real commercial production usage.\n   - *Collaboration & Team Gates (Organizational Trigger)*:\n     - Product is free for 1 user; adding teammate #2 or #3 requires upgrading to Team Plan.\n     - Role-based permissions (RBAC), shared workspaces, and centralized billing.\n   - *Enterprise Governance & Security Gates (Compliance Trigger)*:\n     - SAML SSO (Okta, Azure AD), audit logs, custom data retention, dedicated VPC peering, and 99.99% uptime SLAs.\n\n### Step 2: In-Product Paywall & Upgrade UX\n1. **Contextual Upgrade Modals**:\n   - Never show a generic \"Upgrade Now\" screen. The modal must explicitly state *why* it is being triggered:\n     - Example: *\"You've reached your free limit of 10,000 events this month. Upgrade to Pro to ensure zero dropped events.\"*\n2. **Feature Gate Interaction Modes**:\n   - *Soft Gates (Preview & Unlock)*: Let the user explore the UI of the premium feature (e.g. custom dashboards), but show a clear upgrade banner when they click \"Save\" or \"Apply\".\n   - *Hard Gates (Access Blocked)*: Completely lock enterprise-only settings (e.g. SSO configuration) with a direct \"Request Enterprise Access\" flow.\n3. **1-Click Self-Serve Checkout**:\n   - Integrate Stripe Elements directly into the modal; never force users to leave their current workflow or re-enter billing details if already on file.\n\n### Step 3: Trial-to-Paid Expiration Sequences\n1. **The 14-Day Trial Touchpoint Schedule**:\n   - *Day 0*: Welcome & Guided \"Aha!\" setup checklist.\n   - *Day 3*: Value realization check (did they activate core feature?).\n   - *Day 7*: Mid-trial usage report (\"Your team has processed 14,000 records so far\").\n   - *Day 11 (3 Days Left)*: Urgency notice: \"Your trial ends in 72 hours. Add payment to prevent workflow pause.\"\n   - *Day 14 (Trial End)*: Graceful transition.\n2. **Soft Downgrade Policy**:\n   - When a trial expires without payment, never delete user data immediately. Automatically downgrade them to the Free\u002FRead-Only tier and preserve their workspace for 30 days.\n\n### Step 4: Expansion & Usage Alerts\n1. **Proactive Capacity Warnings**:\n   - Send automated in-app and email alerts at **80%** and **95%** usage thresholds:\n     - *\"You are at 85% of your monthly API quota. Upgrade now or enable automatic overage protection.\"*\n2. **Expansion Plays for Existing Customers**:\n   - Identify accounts approaching seat or compute thresholds and trigger automated account executive outreach for custom annual contracts.\n\n---\n\n## Deliverable Format: Upgrade Architecture Specification (`UPGRADE-PATHS-SPEC.md`)\n\n```markdown\n# Upgrade Path Architecture & Paywall Specification: [Product Name]\n\n## 1. Value Metric & Gate Taxonomy\n| Feature \u002F Tier Gate | Free \u002F Starter | Pro ($[X]\u002Fmo) | Enterprise (Custom) |\n|---|---|---|---|\n| Monthly Events | 10,000 | 250,000 | Custom \u002F Unlimited |\n| Team Members | 1 seat | Up to 10 seats | Unlimited |\n| SSO (SAML\u002FOkta) | No | No | Included |\n| Audit Logs | 7-day retention | 30-day retention | 365-day retention |\n\n## 2. In-Product Paywall UX Specs\n- **Trigger**: User invites 2nd team member on Free Plan.\n- **Headline**: *\"Collaborate with your team in real time\"*\n- **Body Copy**: *\"Free plans include 1 workspace seat. Upgrade to the Team Plan to invite colleagues, share templates, and assign granular permissions.\"*\n- **CTA Button**: `[Upgrade to Team - $29\u002Fmo]` (Instant 1-click modal checkout)\n- **Secondary CTA**: `[Learn more about Team features]`\n\n## 3. Quota Notification Matrix\n| Threshold | Channel | Timing | Copy Hook |\n|---|---|---|---|\n| 80% Usage | In-App Toast | Real-time | \"Approaching free limit (80% used)\" |\n| 95% Usage | Email + Banner | Real-time | \"Action needed: 500 events remaining\" |\n| 100% Usage | Modal Gate | Immediate | \"Limit reached - Upgrade to keep processing\" |\n\n## 4. Post-Trial Soft Downgrade Policy\n- **Grace Period**: 7 days read-only access.\n- **Data Retention**: All projects and configurations preserved for 60 days.\n```\n\n---\n\n## Worked Example: Cloud Developer Tool Upgrade Flow\n\n- **Trigger**: Developer reaches 5 active environments on the free tier and attempts to spin up a 6th.\n- **Modal Display**: Shows an interactive cost slider demonstrating that upgrading to Pro allows 25 environments for $40\u002Fmonth, saving $120\u002Fmonth compared to raw cloud hosting.\n- **Result**: Conversion rate on environment creation paywall hit 19.4%, generating $14,000 in incremental MRR in the first 45 days.\n\n---\n\n## Verification Checklist\n\n- [ ] Upgrade gates align with real business growth milestones (seats, volume, security).\n- [ ] Paywall modals clearly articulate the specific context and value of the locked feature.\n- [ ] Self-serve 1-click upgrade checkout takes $\u003C 30$ seconds.\n- [ ] Automated warning notifications fire at 80% and 95% capacity.\n- [ ] Trial expirations gracefully soft-downgrade to free\u002Fread-only with data preserved.\n\n---\n\n## Anti-Patterns\n\n- **Hostage Paywalls**: Locking users out of viewing or exporting data they created on the free tier.\n- **Mysterious Upgrades**: Showing a generic \"Contact Sales to Upgrade\" modal for a standard $20\u002Fmonth SaaS feature.\n- **Premature Gating**: Gating the core value proposition so aggressively that users never reach the initial \"Aha!\" moment.\n","# upgrade-paths\n\n## Core Philosophy\nFreemium and free trial tiers fail when the upgrade path is invisible, arbitrary, or punitive. The best software upgrades do not feel like an aggressive tollbooth; they feel like a natural, celebrated milestone of business growth. Effective upgrade paths align monetization with the exact moment a customer realizes enterprise scale, mission-critical operational reliance, or collaborative team expansion.\n\n---\n\n## 4-Step Upgrade Path Engineering\n\n### Step 1: Monetization Trigger & Gate Classification\n1. **The 3 Upgrade Trigger Archetypes**:\n   - *Capacity & Usage Limits (Scale Trigger)*:\n     - Free tier covers individual\u002Fhobbyist volume (e.g. 10,000 monthly events, 5GB storage).\n     - Upgrade triggers when volume indicates real commercial production usage.\n   - *Collaboration & Team Gates (Organizational Trigger)*:\n     - Product is free for 1 user; adding teammate #2 or #3 requires upgrading to Team Plan.\n     - Role-based permissions (RBAC), shared workspaces, and centralized billing.\n   - *Enterprise Governance & Security Gates (Compliance Trigger)*:\n     - SAML SSO (Okta, Azure AD), audit logs, custom data retention, dedicated VPC peering, and 99.99% uptime SLAs.\n\n### Step 2: In-Product Paywall & Upgrade UX\n1. **Contextual Upgrade Modals**:\n   - Never show a generic \"Upgrade Now\" screen. The modal must explicitly state *why* it is being triggered:\n     - Example: *\"You've reached your free limit of 10,000 events this month. Upgrade to Pro to ensure zero dropped events.\"*\n2. **Feature Gate Interaction Modes**:\n   - *Soft Gates (Preview & Unlock)*: Let the user explore the UI of the premium feature (e.g. custom dashboards), but show a clear upgrade banner when they click \"Save\" or \"Apply\".\n   - *Hard Gates (Access Blocked)*: Completely lock enterprise-only settings (e.g. SSO configuration) with a direct \"Request Enterprise Access\" flow.\n3. **1-Click Self-Serve Checkout**:\n   - Integrate Stripe Elements directly into the modal; never force users to leave their current workflow or re-enter billing details if already on file.\n\n### Step 3: Trial-to-Paid Expiration Sequences\n1. **The 14-Day Trial Touchpoint Schedule**:\n   - *Day 0*: Welcome & Guided \"Aha!\" setup checklist.\n   - *Day 3*: Value realization check (did they activate core feature?).\n   - *Day 7*: Mid-trial usage report (\"Your team has processed 14,000 records so far\").\n   - *Day 11 (3 Days Left)*: Urgency notice: \"Your trial ends in 72 hours. Add payment to prevent workflow pause.\"\n   - *Day 14 (Trial End)*: Graceful transition.\n2. **Soft Downgrade Policy**:\n   - When a trial expires without payment, never delete user data immediately. Automatically downgrade them to the Free\u002FRead-Only tier and preserve their workspace for 30 days.\n\n### Step 4: Expansion & Usage Alerts\n1. **Proactive Capacity Warnings**:\n   - Send automated in-app and email alerts at **80%** and **95%** usage thresholds:\n     - *\"You are at 85% of your monthly API quota. Upgrade now or enable automatic overage protection.\"*\n2. **Expansion Plays for Existing Customers**:\n   - Identify accounts approaching seat or compute thresholds and trigger automated account executive outreach for custom annual contracts.\n\n---\n\n## Deliverable Format: Upgrade Architecture Specification (`UPGRADE-PATHS-SPEC.md`)\n\n```markdown\n# Upgrade Path Architecture & Paywall Specification: [Product Name]\n\n## 1. Value Metric & Gate Taxonomy\n| Feature \u002F Tier Gate | Free \u002F Starter | Pro ($[X]\u002Fmo) | Enterprise (Custom) |\n|---|---|---|---|\n| Monthly Events | 10,000 | 250,000 | Custom \u002F Unlimited |\n| Team Members | 1 seat | Up to 10 seats | Unlimited |\n| SSO (SAML\u002FOkta) | No | No | Included |\n| Audit Logs | 7-day retention | 30-day retention | 365-day retention |\n\n## 2. In-Product Paywall UX Specs\n- **Trigger**: User invites 2nd team member on Free Plan.\n- **Headline**: *\"Collaborate with your team in real time\"*\n- **Body Copy**: *\"Free plans include 1 workspace seat. Upgrade to the Team Plan to invite colleagues, share templates, and assign granular permissions.\"*\n- **CTA Button**: `[Upgrade to Team - $29\u002Fmo]` (Instant 1-click modal checkout)\n- **Secondary CTA**: `[Learn more about Team features]`\n\n## 3. Quota Notification Matrix\n| Threshold | Channel | Timing | Copy Hook |\n|---|---|---|---|\n| 80% Usage | In-App Toast | Real-time | \"Approaching free limit (80% used)\" |\n| 95% Usage | Email + Banner | Real-time | \"Action needed: 500 events remaining\" |\n| 100% Usage | Modal Gate | Immediate | \"Limit reached - Upgrade to keep processing\" |\n\n## 4. Post-Trial Soft Downgrade Policy\n- **Grace Period**: 7 days read-only access.\n- **Data Retention**: All projects and configurations preserved for 60 days.\n```\n\n---\n\n## Worked Example: Cloud Developer Tool Upgrade Flow\n\n- **Trigger**: Developer reaches 5 active environments on the free tier and attempts to spin up a 6th.\n- **Modal Display**: Shows an interactive cost slider demonstrating that upgrading to Pro allows 25 environments for $40\u002Fmonth, saving $120\u002Fmonth compared to raw cloud hosting.\n- **Result**: Conversion rate on environment creation paywall hit 19.4%, generating $14,000 in incremental MRR in the first 45 days.\n\n---\n\n## Verification Checklist\n\n- [ ] Upgrade gates align with real business growth milestones (seats, volume, security).\n- [ ] Paywall modals clearly articulate the specific context and value of the locked feature.\n- [ ] Self-serve 1-click upgrade checkout takes $\u003C 30$ seconds.\n- [ ] Automated warning notifications fire at 80% and 95% capacity.\n- [ ] Trial expirations gracefully soft-downgrade to free\u002Fread-only with data preserved.\n\n---\n\n## Anti-Patterns\n\n- **Hostage Paywalls**: Locking users out of viewing or exporting data they created on the free tier.\n- **Mysterious Upgrades**: Showing a generic \"Contact Sales to Upgrade\" modal for a standard $20\u002Fmonth SaaS feature.\n- **Premature Gating**: Gating the core value proposition so aggressively that users never reach the initial \"Aha!\" moment.\n",{"name":5,"group":24,"description":7,"last_reviewed":25},"Lifecycle",1788652800000,"main","e9ea1069b8d051ec6f88c3bdc4290183b8e68c94","skills\u002Fupgrade-paths","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskillary","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp","poorvithmp.com","Shipping tools for problems people notice too late.","2026-10-02 21:32:44",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add poorvith-mp\u002Fskills-marketing --skill upgrade-paths",{"tool":41,"command":42},"bunx","bunx skills add poorvith-mp\u002Fskills-marketing --skill upgrade-paths",{"tool":44,"command":45},"pnpm","pnpm dlx skills add poorvith-mp\u002Fskills-marketing --skill upgrade-paths","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fupgrade-paths\u002FSKILL.md",true,[49,55],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Frouting.yaml","REFERENCE","参考文档",1004,"https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fupgrade-paths\u002Fevals\u002Frouting.yaml",{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"upgrade-paths.skill","OTHER","其他",3838,"https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fupgrade-paths\u002Fupgrade-paths.skill",[62,69,75,81,88,94],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M792Y3WSAZ5ABHX58QPMWXMH","youtube-clipper","Moved to modernized catalog in skillary. Removed in v4.1.","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube-clipper\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M792Y1ABERS38QWQCJ9CKWJB","youtube-b-roll-maker","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube-b-roll-maker\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M792XZCWKZV16GNK3QQR9M2X","x-twitter-intelligence-analyst","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fx-twitter-intelligence-analyst\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M792XTYRW8ZSHPSPVMK301QW","visual-assets","Generate on-brand images: OG cards, blog heroes, social graphics and mockups. Use when creating Open Graph cards, hero visuals, or brand graphics.","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-assets\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M792XR5BZ510MFZETMPAAJBW","viral-hook-generator","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fviral-hook-generator\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M792XPJB02Q3HQTKKYZTKJ8A","video-script-writer","https:\u002F\u002Fgithub.com\u002Fpoorvith-mp\u002Fskills-marketing\u002Fblob\u002Fmain\u002Fskills\u002Fvideo-script-writer\u002FSKILL.md",[],[]]