integration-clerk

Connect Clerk authentication to a self-hosted Hermes agent over SSH.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-clerk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-clerk
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-clerk
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-clerk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual work of connecting Clerk authentication and user management to a self-hosted Hermes agent, so an AI agent can provision the integration over SSH with strong safety checks.

Core Features & Use Cases

  • Backend API Wiring: Stores a Clerk secret key on the VPS and verifies live API access with Bearer authentication.
  • Production Safety Gates: Refuses to wire live keys without explicit production acknowledgment and validates key format before making changes.
  • Rollback-Safe Deployment: Supports idempotent setup, gateway reloads, smoke tests, and cleanup if verification fails.
  • Use Case: Use it when you want your Hermes agent to manage Clerk users, sessions, organizations, invitations, or bans from a remote server without exposing secrets in chat or client code.

Quick Start

Ask the agent to connect Clerk to your Hermes VPS using the SSH host, SSH user, and Clerk secret key, and to prefer the test key unless you explicitly approve production access.

Frequently Asked Questions about integration-clerk

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

FAQPage Schema
How do I connect Clerk authentication to a self-hosted Hermes agent over SSH?

To connect Clerk to Hermes, provide the SSH host, SSH user, and Clerk secret key to the agent. The setup provisions the integration remotely, stores the key safely on the VPS, and verifies live Backend API access.

Can I use my live Clerk production keys when wiring authentication into Hermes?

Yes, but the system refuses to wire live Clerk production keys without your explicit production acknowledgment. It validates the key format first and defaults to using the test key unless you specifically approve production access.

What happens if Clerk Backend API verification fails during the Hermes setup?

If Clerk API verification fails, the deployment supports rollback-safe execution by running cleanup procedures. It applies idempotent setup, gateway reloads, and smoke tests to ensure a safe state without leaving broken configurations.

Does the Clerk and Hermes integration support user sessions and organization management?

Yes, the integration includes optional MCP wiring for Clerk user management, sessions, organizations, invitations, and role management. This allows the Hermes agent to handle these operations securely from the remote server.

Do I need to expose my Clerk secret key in chat when configuring the Hermes VPS?

No, you do not need to expose the Clerk secret key in chat or client code. The Skill stores the secret key directly on the VPS over SSH and uses Bearer authentication to verify live API access safely.