К основному содержанию
скилл CX Codex

clerk-cost-tuning — скилл для Claude Code: что делает и как установить

Скилл clerk-cost-tuning разбирает тарификацию Clerk по MRU и помогает урезать счёт: авторизация только на нужных маршрутах, кеш вокруг Backend API, скрипт поиска неактивных аккаунтов.

MIT 1 установок ★ 2 935 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill clerk-cost-tuning -a claude-code
Открыть на GitHub

Что делает clerk-cost-tuning

Скилл разбирает, за что Clerk берёт деньги, и правит код так, чтобы счёт был меньше. Тарифов четыре: Free за $0 с 50,000 MRU, Pro за $25 в месяц ($20 при годовой оплате), Business за $300 в месяц ($250 при годовой), Enterprise по договору. Сверх включённых 50,000 MRU каждый следующий пользователь стоит $0.02. MRU — это тот, кто вернулся в приложение через 24 часа и позже: активность в день регистрации не считается, боты и просмотры публичных страниц тоже.

Дальше идут шаги по коду: auth.protect() переезжает в middleware.ts и закрывает только названные маршруты, вызовы Clerk Backend API оборачиваются в cache() и unstable_cache(), появляется админский эндпоинт с числом пользователей и скрипт поиска аккаунтов без входа 90 дней. Инструменты у скилла — Read, Write, Edit, Grep: код он пишет и правит сам, а запускать скрипты остаётся вам.

Нужен активный аккаунт Clerk и понимание, как у вас устроены сессии, — иначе шаги про маршруты и кеш останутся общими словами. Тестовые инстансы бесплатны и без ограничений, поэтому новую проверку авторизации лучше обкатать там, а не на проде.

Какие задачи решает

  • посчитать, во что обойдётся переход с Free на Pro при текущем числе MRU
  • убрать проверку входа с публичных страниц и оставить её только в кабинете
  • закешировать метаданные пользователя, чтобы не дёргать Backend API на каждом запросе
  • найти аккаунты, которые не заходили 90 дней
  • собрать админский эндпоинт с общим числом пользователей

Примеры запросов агенту

  • Почему у нас вырос счёт в Clerk? Разбери тариф и покажи, где мы платим лишнее.
  • Перенеси auth.protect() в middleware.ts только на /dashboard и /settings, публичные страницы оставь открытыми.
  • Напиши скрипт, который найдёт пользователей Clerk без входа 90 дней.

Как установить clerk-cost-tuning

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill clerk-cost-tuning -a claude-code

2Вручную: положить файлы

~/.claude/skills/clerk-cost-tuning/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/clerk-cost-tuning/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о clerk-cost-tuning

Как установить clerk-cost-tuning в Claude Code?

Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill clerk-cost-tuning -a claude-code. Файл скилла окажется по пути ~/.claude/skills/clerk-cost-tuning/SKILL.md.

Что делает clerk-cost-tuning?

Объясняет тарификацию Clerk по MRU и правит проект под меньший счёт: ограничивает авторизацию нужными маршрутами, добавляет кеширование и собирает мониторинг расхода.

Кого Clerk считает в MRU?

Того, кто вернулся в приложение через 24 часа после регистрации или позже. Активность в день регистрации, боты и посетители публичных страниц в счёт не идут.

Исходный текст

SKILL.md · MIT
---
name: clerk-cost-tuning
description: 'Optimize Clerk costs and understand pricing.

  Use when planning budget, reducing costs,

  or understanding Clerk pricing model.

  Trigger with phrases like "clerk cost", "clerk pricing",

  "reduce clerk cost", "clerk billing", "clerk budget".

  '
allowed-tools: Read, Write, Edit, Grep
version: 1.15.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- clerk
- cost-optimization
compatibility: Designed for Claude Code
---
# Clerk Cost Tuning

## Overview

Understand Clerk pricing and optimize costs. Clerk charges by Monthly Retained Users (MRU) — a user is counted as retained only when they return 24+ hours after signing up. Covers pricing tiers, MRU reduction strategies, caching to reduce API calls, and usage monitoring.

## Prerequisites

- Clerk account active
- Understanding of MRU (Monthly Retained Users)
- Application usage patterns known

## Instructions

### Step 1: Understand Clerk Pricing Model

| Plan | Price | MRU Included | Extra MRU |
|------|-------|-------------|-----------|
| Free (Hobby) | $0/mo | 50,000 MRU | N/A |
| Pro | $25/mo ($20/mo billed annually) | 50,000 MRU | $0.02/MRU |
| Business | $300/mo ($250/mo billed annually) | 50,000 MRU | $0.02/MRU |
| Enterprise | Custom | Custom | Custom |

Key pricing concepts:

- **MRU** = unique user who returns to your app 24+ hours after signing up ("first day free" — sign-up-day activity never counts)
- Users who sign up and never return are not billed
- Users who only visit public pages are not counted
- Bot/crawler sessions are not counted
- Test/development instances are free and unlimited

### Step 2: Reduce MRU Count

```typescript
// Strategy 1: Defer authentication — don't force sign-in until necessary
// middleware.ts
import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server'

const requiresAuth = createRouteMatcher([
  '/dashboard(.*)',
  '/settings(.*)',
  '/api/protected(.*)',
])

export default clerkMiddleware(async (auth, req) => {
  // Only require auth for specific routes (not entire site)
  if (requiresAuth(req)) {
    await auth.protect()
  }
})
```

```typescript
// Strategy 2: Use anonymous access for read-only features
// app/blog/[slug]/page.tsx
import { auth } from '@clerk/nextjs/server'

export default async function BlogPost({ params }: { params: { slug: string } }) {
  const { userId } = await auth() // Check but don't require
  const post = await db.post.findUnique({ where: { slug: params.slug } })

  return (
    <article>
      <h1>{post?.title}</h1>
      <div>{post?.content}</div>
      {userId ? <CommentForm /> : <p>Sign in to comment</p>}
    </article>
  )
}
```

### Step 3: Cache to Reduce API Calls

```typescript
// lib/user-cache.ts
import { cache } from 'react'
import { currentUser } from '@clerk/nextjs/server'

// Deduplicate within single request (free)
export const getUser = cache(async () => {
  return currentUser()
})

// Cross-request caching reduces Backend API calls
import { unstable_cache } from 'next/cache'
import { clerkClient } from '@clerk/nextjs/server'

export const getUserMetadata = unstable_cache(
  async (userId: string) => {
    const client = await clerkClient()
    const user = await client.users.getUser(userId)
    return user.publicMetadata
  },
  ['user-metadata'],
  { revalidate: 600 } // 10-minute cache
)
```

### Step 4: Monitor Usage

```typescript
// app/api/admin/clerk-usage/route.ts
import { auth, clerkClient } from '@clerk/nextjs/server'

export async function GET() {
  const { has } = await auth()
  if (!has({ role: 'org:admin' })) {
    return Response.json({ error: 'Admin only' }, { status: 403 })
  }

  const client = await clerkClient()
  const users = await client.users.getUserList({ limit: 1 })

  return Response.json({
    totalUsers: users.totalCount,
    // Estimate MRU based on recent sign-ins
    estimatedMRU: 'Check Clerk Dashboard > Billing for actual MRU',
    dashboardUrl: 'last-active?after=30d',
  })
}
```

### Step 5: Clean Up Inactive Users

```typescript
// scripts/cleanup-inactive-users.ts
import { createClerkClient } from '@clerk/backend'

const clerk = createClerkClient({ secretKey: process.env.CLERK_SECRET_KEY! })

async function findInactiveUsers(daysInactive = 90) {
  const cutoff = Date.now() - daysInactive * 24 * 60 * 60 * 1000
  const allUsers = await clerk.users.getUserList({ limit: 500 })

  const inactive = allUsers.data.filter(
    (user) => (user.lastSignInAt || 0) < cutoff
  )

  console.log(`Found ${inactive.length} users inactive for ${daysInactive}+ days`)
  console.log('Consider: notification campaign, data export, or account cleanup')

  return inactive
}

findInactiveUsers()
```

## Output

- Pricing model understood with MRU thresholds
- Route-level auth to minimize unnecessary MRU counts
- Request-level and cross-request caching reducing API calls
- Usage monitoring endpoint for admins
- Inactive user identification script

## Error Handling

| Issue | Cause | Solution |
|-------|-------|----------|
| Unexpected bill increase | MRU spike from bot traffic | Add bot detection, restrict auth to needed routes |
| Feature limitations | Free tier limits (no SSO, etc.) | Upgrade to Pro ($25/mo, or $20/mo billed annually) |
| High API call volume | No caching | Add React `cache()` + `unstable_cache()` |
| MRU count mismatch | Counting test users | Use separate dev instance (free, unlimited) |

## Examples

### Cost Estimation Script

```typescript
function estimateMonthlyCost(mru: number): string {
  if (mru <= 50_000) return 'Free tier ($0/mo)'
  const overage = mru - 50_000
  const cost = 25 + overage * 0.02
  return `Pro tier: $${cost.toFixed(2)}/mo (${overage.toLocaleString()} extra MRU at $0.02 each)`
}

console.log(estimateMonthlyCost(15_000))  // "Free tier ($0/mo)"
console.log(estimateMonthlyCost(60_000))  // "Pro tier: $225.00/mo (10,000 extra MRU at $0.02 each)"
```

## Resources

- [Clerk Pricing](https://clerk.com/pricing)
- Clerk Usage Dashboard
- Clerk Fair Use Policy

## Next Steps

Proceed to `clerk-reference-architecture` for architecture patterns.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
clerk-nextjs-patterns clerk Скилл clerk-nextjs-patterns для Claude Code и Codex помогает внедрять авторизацию Clerk в Next.js. Направляет агента при настройке Server Actions, middleware и кеширования. CX Codex +1 56 200установок clerk-webhooks clerk Скилл clerk-webhooks для Claude Code помогает создавать обработчики вебхуков Clerk с проверкой подписи. Запускается при настройке синхронизации данных и действий на событиях Clerk. CX Codex +1 55 700установок clerk-nextjs-skills gocallum Скилл clerk-nextjs-skills подключает аутентификацию Clerk в Next.js 16 с App Router: proxy.ts, переменные окружения, защита маршрутов и MCP-сервер. CX Codex +1 438установок clerk-auth davila7 Скилл clerk-auth помогает внедрить авторизацию Clerk в Next.js App Router, настроить защиту маршрутов через middleware и связать сессии с серверными компонентами. CX Codex +1 62установок Clerk clerk MCP-сервер для интеграции с Clerk. Помогает находить готовые сниппеты SDK, настраивать учётные записи и управлять сессиями прямо в диалоге с ассистентом. CX Codex +1 407установок clerk-authentication Mindrally Скилл clerk-authentication для Claude Code: правила подключения Clerk в Next.js — middleware, хуки, защита серверных действий и маршрутов API. Держит проверки доступа в порядке на проекте с Clerk. CX Codex +1 724установок

Из того же набора139

Весь набор →
juicebox-cost-tuning Скилл juicebox-cost-tuning помогает контролировать расходы Juicebox: сокращает лишние запросы и обогащение профилей, а изменения проверяет на тестовом стенде. CX Codex +1 1установок twinmind-cost-tuning Скилл twinmind-cost-tuning для Claude Code помогает выбрать тариф TwinMind и отслеживать расход минут. Контролирует минуты расшифровки при частых встречах. CX Codex +1 1установок openevidence-cost-tuning Скилл openevidence-cost-tuning оценивает внедрение и затраты на OpenEvidence в клинике без выдумывания цен и лимитов. Помогает подготовить отчёт к продлению подписки. CX Codex +1 1установок deepgram-cost-tuning Скилл deepgram-cost-tuning помогает контролировать расходы на Deepgram: оценивает стоимость транскрибации, учитывает использование API и предлагает сократить оплачиваемую длительность аудио. CX Codex +1 1установок lindy-cost-tuning Скилл lindy-cost-tuning анализирует расход кредитов в Lindy AI, помогает подобрать более дешёвые модели и объединить дублирующих агентов. CX Codex +1 1установок evernote-cost-tuning Скилл evernote-cost-tuning для Claude Code отслеживает квоты загрузки Evernote, оценивает размер вложений и находит крупные заметки. Проверяет лимит до загрузки в интеграциях. CX Codex +1 1установок posthog-cost-tuning Скилл posthog-cost-tuning считает, за что PostHog выставляет счёт, и режет шум в захвате событий, не теряя данные, нужные для решений. CX Codex +1 1установок ideogram-cost-tuning Скилл ideogram-cost-tuning настраивает контроль расходов на генерацию изображений через API Ideogram. Помогает задать лимиты запросов, отсечь дубликаты и учитывать только сохранённые результаты. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой