Skip to content
cccskills
FreePublished on GitHub

billing

Guide changes to Kortix billing code, admin controls, and pricing screens. Explain how plans, trials, enterprise contracts, and access exceptions should work, where pricing is defined, and which audited routes must handle account changes.

OriginalShow the original description

Kortix billing: plans (Free, Credits, Enterprise), credits and the wallet, compute and model pricing, trials, enterprise contracts, entitlement overrides and who may manage billing. Load before changing anything under apps/api/src/billing, the admin account billing routes, the web billing/pricing UI, or plan copy.

Works withStripe
See how to install

Good for

  • Update billing logic and its specification together
  • Review how trials and enterprise contracts are handled
  • Find the code that defines prices and allowances
  • Update billing screens to show account status

Files included (2)

  • SKILL.md2.1 KB
  • references/plans-and-access.md9.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Billing

The plan model and its lifecycle are specified in references/plans-and-access.md. Read it before you change billing code. Change the code and the spec together.

Rules

  • The plan alone decides features. Never add a flag that turns on part of a plan. Time-boxed access is a trial; an exception is an entitlement_overrides key.
  • One write path. Plan, trial, contract and override changes go through the audited admin routes in apps/api/src/admin/index.ts. Never write those columns with raw SQL in production.
  • Stripe never overwrites Enterprise. applyStripeSync skips tier writes on an Enterprise account; only activateEnterpriseContract and the contract end set or clear it.
  • Prices live in code once. Credits: billing/services/tiers.ts. Compute: platform/providers/compute-rates.ts, mirrored by packages/ui/src/internal/billing/compute-pricing.ts. Model fee: LLM_PLATFORM_FEE_PERCENT.
  • Customers always see their state. A new plan state needs an account-state field and a visible label.

Where the code lives

ConcernCode
Plan resolution (plan, trial, overrides, grace)apps/api/src/billing/services/resolve-billing.ts
Plans, prices, allowancesapps/api/src/billing/services/tiers.ts
Enterprise contractsapps/api/src/billing/services/enterprise-contracts.ts
Trialsapps/api/src/billing/services/trial-admin.ts
Warnings and expiry sweepsapps/api/src/billing/rotation-schedule.ts, workers/billing-rotation-worker.ts
Stripe webhooksapps/api/src/billing/services/webhooks.ts, stripe-checkout-webhooks.ts
Account state APIapps/api/src/billing/services/account-state.ts
Admin consoleapps/web/src/app/[locale]/admin/accounts/
Customer UIapps/web/src/features/billing/

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

access-policy

FreeSummary

Review Slack access requests against Okta role and team information, then prepare narrowly scoped GitHub or AWS IAM permissions. Apply changes only after an eligible person's approval and record the grant, reasoning, approver, and timestamp.

  • Reviewing GitHub repository access requests from Slack
  • Preparing AWS IAM permissions for a specific task
  • Routing sensitive access requests for additional review
kortix-ai/suna20.3KUpdated Oct 21, 2026

account-research

FreeSummary

Research companies and people before outreach or meetings. Combines business profiles, recent news, hiring signals, and key contacts into a sourced brief with talking points and suggested questions, adding relationship history when CRM data is connected.

  • Research a prospective customer before outreach
  • Prepare background information for meeting attendees
  • Compare a competitor's products and positioning
kortix-ai/suna20.3KUpdated Oct 21, 2026

Review daily Google Ads and Meta Ads results for budget pacing, declining performance, and unusual activity. Get prioritized findings with supporting numbers and concrete recommendations for a marketing team to assess and carry out.

  • Checking whether campaign budgets are being spent on schedule
  • Investigating rising acquisition costs or falling ad returns
  • Finding ads and keywords that spend without converting
kortix-ai/suna20.3KUpdated Oct 21, 2026

agent-browser

FreeSummary

Automate website tasks such as navigating pages, filling forms, clicking buttons, taking screenshots, and extracting data. The skill also supports web app testing, with specialized guides for Electron desktop apps, Slack, and cloud browsers.

  • Automate form entry and page navigation
  • Capture screenshots and extract page data
  • Explore web apps for bugs
kortix-ai/suna20.3KUpdated Oct 21, 2026

ap-invoice-match

FreeSummary

Process emailed vendor invoices by extracting details, comparing them with purchase orders and invoice history, and recording duplicates, overcharges, or missing orders. Summarize results in Slack for human review; payment approval and execution remain with people.

  • Checking incoming invoices against purchase orders
  • Finding duplicate invoices and likely resends
  • Reviewing unit prices and remaining order balances
kortix-ai/suna20.3KUpdated Oct 21, 2026

Monitor public news, social platforms, and forums for new brand mentions. Remove previously reported results, classify sentiment, and send a Slack digest with response drafts for negative or notable mentions, leaving public replies to people.

  • Track new brand mentions each day
  • Identify negative or widely seen mentions
  • Prepare response drafts for human review
kortix-ai/suna20.3KUpdated Oct 21, 2026

See all skills by kortix-ai

Report a problem with this skill