clerk
Get user metrics from Clerk (total users, active users, new users)
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.
| name | clerk |
|---|---|
| description | Get 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_KEYenvironment variable must be set (starts withsk_live_orsk_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
- getCount() - Get total user count
- getUserList() - List users with filters
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