clerk-backend-api

Manages and updates Clerk Backend resources via authenticated API calls.

1|Updated Jun 13, 2017
One-click install
npx skills add https://github.com/RoyMcCrain/dotsfile --skill clerk-backend-api-roymccrain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clerk-backend-api
Source: https://github.com/RoyMcCrain/dotsfile/tree/main/claude/skills/clerk-backend-api
Command: npx skills add https://github.com/RoyMcCrain/dotsfile --skill clerk-backend-api-roymccrain

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually constructing and executing Clerk Backend API requests is error‑prone, especially when handling authentication, scope checks, and metadata updates. This Skill automates safe request formation, validation, and response parsing, reducing the risk of accidental data loss.

Core Features & Use Cases

  • Safe write operations: Enforces CLERK_SECRET_KEY presence, scope verification, and irreversible‑action warnings before any POST, PATCH, PUT, or DELETE.
  • Fast‑path commands: Ready‑to‑run curl templates for common tasks like listing users, creating organizations, inviting members, and updating user metadata.
  • Metadata guidance: Explains public, private, and unsafe metadata types and ensures correct usage.
  • Spec‑driven browsing: Allows tag and endpoint exploration from Clerk’s OpenAPI specifications.
  • Rate‑limit awareness: Provides production and development limits and suggests mitigation strategies.

Quick Start

Ask the clerk-backend-api skill to list all users created in the last seven days.

Frequently Asked Questions about clerk-backend-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely execute Clerk Backend API calls for user management?

To safely execute Clerk Backend API calls, this Skill enforces CLERK_SECRET_KEY presence and scope verification, issuing warnings before any mutating POST, PATCH, PUT, or DELETE requests to prevent accidental data loss.

Can I update Clerk user metadata through the Backend API?

Yes, you can update Clerk user metadata through the Backend API. This Skill provides ready-to-run templates and guidance for correctly applying public, private, and unsafe metadata types to user profiles.

How do I list users created in the last seven days using the Clerk Backend API?

You can list users created in the last seven days by asking this Skill to execute the list users command. It generates ready-to-run curl templates for common tasks like listing users and creating organizations.

What environment variables do I need to make mutating Clerk Backend API requests?

To make mutating Clerk Backend API requests, you need the CLERK_SECRET_KEY environment variable for authentication. The Skill also respects CLERK_BAPI_SCOPES to enforce safety checks before any write operations.

Does the Clerk Backend API have rate limits I should be aware of?

Yes, the Clerk Backend API has production and development rate limits. This Skill provides information on these limits and suggests mitigation strategies to help you avoid hitting them during user management operations.

How do I browse Clerk OpenAPI specifications to find the right backend endpoints?

You can browse Clerk OpenAPI specifications by asking this Skill to explore tags and endpoints. It allows spec-driven browsing to help you find the correct backend API endpoints for your organization and user management tasks.