clerk

vm0-ai's avatarfrom vm0-ai

Get user metrics from Clerk (total users, active users, new users)

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 1, 2026⬇️1downloads

When & Why to Use This Skill

The Clerk User Metrics skill allows Claude to programmatically retrieve and analyze user growth data from the Clerk authentication platform. It streamlines the process of fetching total user counts, daily active users, and new sign-ups, transforming raw API data into actionable insights for product managers and developers.

Use Cases

  • Daily Growth Tracking: Automatically fetch and summarize the number of new users joined yesterday to monitor marketing campaign performance.
  • Engagement Monitoring: Retrieve active user metrics for specific dates to analyze retention trends and platform usage health.
  • Automated Reporting: Generate quick snapshots of total user milestones for stakeholder updates or internal progress reports without manual dashboard exports.
  • Data Export for Analytics: Save user statistics into structured JSON files for integration with other business intelligence tools or custom spreadsheets.
nameclerk
descriptionGet user metrics from Clerk (total users, active users, new users)

Clerk User Metrics Skill

Fetches user statistics from Clerk authentication service.

When to Use

Use this skill when you need to get:

  • Total user count
  • Active users (users with activity yesterday)
  • New users (users created yesterday)

How to Use

# Get yesterday's user metrics (default)
$CLAUDE_CONFIG_DIR/skills/clerk/scripts/get-users.sh

# Get metrics for a specific date
$CLAUDE_CONFIG_DIR/skills/clerk/scripts/get-users.sh "2024-12-17"

Arguments

  • date (optional): Specific date in YYYY-MM-DD format. Defaults to yesterday.

Prerequisites

  • CLERK_SECRET_KEY environment variable must be set (starts with sk_live_ or sk_test_)

Output

Results are saved to /tmp/data/clerk_users_[timestamp].json:

{
  "date": "2024-12-17",
  "total_users": 150,
  "active_users": 25,
  "new_users": 5
}

Console output:

Clerk User Metrics for 2024-12-17
Total Users: 150
Active Users: 25
New Users: 5

API Reference

Error Handling

  • 401 Unauthorized: Check that CLERK_SECRET_KEY is set correctly
  • 403 Forbidden: The API key may not have the required permissions
  • 429 Rate Limited: Too many requests, try again later