Shows a graceful upgrade prompt when a user attempts to use a premium feature without the required tier. Uses AskUserQuestion for interactive selection. Do NOT use directly - this is invoked by the gating hook when premium features are accessed.
/plugin marketplace add jrc1883/popkit-claude/plugin install popkit@popkit-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Shows a graceful, interactive upgrade prompt when free tier users attempt to use premium features. Offers upgrade option and free tier fallback when available.
Core principle: Be helpful, not hostile. Show users what they're missing without blocking their workflow.
Trigger: Called by pre-tool-use hook when gating check fails.
| Argument | Description |
|---|---|
feature_name | The premium feature being accessed |
feature_description | What the feature does |
required_tier | Tier required (pro, team) |
user_tier | User's current tier |
fallback | Optional free tier alternative |
## ⭐ Premium Feature Required
**{feature_name}**
{feature_description}
| Your Tier | Required Tier |
|-----------|---------------|
| {user_tier} | {required_tier} |
Use AskUserQuestion for selection:
Use AskUserQuestion tool with:
- question: "This feature requires {required_tier}. What would you like to do?"
- header: "Premium"
- options:
- label: "Upgrade to {required_tier}"
description: "Unlock this feature and more (${price}/mo)"
- label: "Continue with free tier" (if fallback available)
description: "{fallback}"
- label: "Cancel"
description: "Return without using this feature"
- multiSelect: false
If "Upgrade":
Execute /popkit:upgrade {required_tier}
If "Continue with free tier":
Using free tier alternative: {fallback}
Note: Some capabilities will be limited.
Run `/popkit:upgrade` anytime to unlock full features.
Then continue with the limited workflow.
If "Cancel":
Cancelled. Run `/popkit:upgrade` when you're ready to unlock premium features.
| Feature | Tier | Price | Free Fallback |
|---|---|---|---|
| Custom MCP servers | Pro | $9/mo | Basic project analysis |
| Custom skills | Pro | $9/mo | View existing skills |
| Custom routines | Pro | $9/mo | Default routines |
| Multi-project dashboard | Pro | $9/mo | Single project |
| Pattern sharing | Pro | $9/mo | Search only |
| Project embeddings | Pro | $9/mo | Basic search |
| Hosted Power Mode | Pro | $9/mo | File-based (2-3 agents) |
| Team coordination | Team | $29/mo | None |
| Team analytics | Team | $29/mo | None |
User runs: /popkit:project generate
Gating hook detects: User is free tier, feature requires Pro
This skill shows:
## ⭐ Premium Feature Required
**Custom MCP Server Generation**
Generate project-specific MCP servers with semantic search,
custom health checks, and project-aware tooling.
| Your Tier | Required Tier |
|-----------|---------------|
| Free | Pro |
[AskUserQuestion appears with options]
User selects: "Continue with free tier"
Result:
Using free tier alternative: Basic project analysis available (no custom MCP)
Analyzing project structure...
[continues with limited analysis]
hooks/utils/premium_checker.py - Entitlement checking logic/popkit:upgrade - Upgrade command/popkit:account - Account managementThis skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.