菜单
Commet behavior rules and business logic. Use when implementing billing features, subscription changes, plan changes, proration, pricing, credits, balance, intro offers, or any billing edge case. Contains detailed rules for how changes affect customers.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when billing for AI model token usage — setting up @commet/ai-sdk tracked() middleware, configuring balance consumption model plans with AI model pricing, tracking input/output/cache tokens, cost calculation with margins, or building AI products that need usage-based billing.
Use when working with the Commet CLI -- logging in, linking projects, syncing billing config as code (commet pull/push), forwarding webhooks locally (commet listen), scaffolding new projects from templates (fixed, seats, metered, credits, balance-ai, balance-fixed), or running resource commands from the terminal.
Integrate Commet billing and payments into any application. Use when working with @commet/node, @commet/next, @commet/better-auth, the Commet CLI, or building billing features like subscriptions, usage tracking, seat management, checkout, customer portal, webhooks, feature gating, or payment flows. Triggers on imports from "@commet/node", "@commet/next", "@commet/better-auth", commet SDK usage, billing integration tasks, or mentions of Commet.
Use when setting up Commet webhook endpoints, verifying signatures, handling billing events (subscription.created, subscription.activated, subscription.canceled, subscription.updated, payment.received, payment.failed, invoice.created), or building event-driven billing workflows.
| name | billing-behaviors |
| description | Commet behavior rules and business logic. Use when implementing billing features, subscription changes, plan changes, proration, pricing, credits, balance, intro offers, or any billing edge case. Contains detailed rules for how changes affect customers. |
| license | MIT |
| metadata | {"author":"commet","version":"1.0.0","homepage":"https://commet.co","source":"https://github.com/commet-labs/commet-skills"} |
| references | ["references/subscription-changes.md","references/pricing-changes.md","references/feature-changes.md","references/plan-management.md","references/intro-offer.md","references/consumption-models.md","references/edge-cases.md","references/domain-billing-engine.md","references/domain-subscriptions.md","references/domain-plans.md","references/domain-features.md","references/domain-usage.md","references/domain-seats.md","references/domain-customers.md","references/domain-plan-groups.md","references/domain-addons.md","references/domain-ai-costs.md","references/domain-promo-codes.md"] |
This skill contains the detailed business behavior rules for Commet. Load the specific files you need based on the task.
Commet does what's fair by default:
| Change Type | When Applied |
|---|---|
| Benefits customer | Immediately |
| Hurts customer | At renewal |
Benefits customer: More limits (API calls, storage), adding features, more included seats. Hurts customer: Price increase, reduced limits, removing features, fewer included seats.
| Actor | Where They Act | Examples |
|---|---|---|
| Founder | Dashboard | Change prices, edit features, deprecate plans |
| Customer | Customer Portal | Upgrade, downgrade, change billing interval |
| System | Automatic | Trial end, payment failure, billing |
Who makes the change?
│
├─ FOUNDER (Dashboard)
│ ├─ Benefits customer? → IMMEDIATE
│ └─ Hurts customer? → AT RENEWAL
│ └─ Delete plan/customer? → See references/plan-management.md
│
└─ CUSTOMER (Portal)
├─ Upgrade (more expensive)? → IMMEDIATE + proration
└─ Downgrade (cheaper)? → AT RENEWAL
Each file covers a specific aspect of billing behavior:
Module-specific knowledge for understanding the codebase: