# Plans Handler

> Manage subscription plans, pricing, and quotas. Use when adding plan features, updating limits, or building pricing pages.

- Skill: `aiskillstore/plans-handler` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/plans-handler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/plans-handler/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/plans-handler

---


# Plans Handler

## Instructions

### 1. Adding a New Limit (Quota)
1.  **DB Schema**: Add field to `quotaSchema` in `src/db/schema/plans.ts`.
2.  **Validation**: Add field to `planFormSchema` in `src/lib/validations/plan.schema.ts`.
3.  **UI**: Add input to `src/components/forms/plan-form.tsx`.
4.  **Data**: Ask user to update the plan via `/super-admin/plans` dashboard.

### 2. Creating a Pricing Table
1.  Fetch plans via API.
2.  Use `getSubscribeUrl` for buttons.
3.  Display features from `plan.quotas`.

### 3. Accessing User Plan
- **Client**: `useCurrentPlan()` (SWR).
- **Server**: `withAuthRequired` wrapper -> `getCurrentPlan()`.

## Reference
For schema details and best practices, see [reference.md](reference.md).