Clerk Astro Patterns

What it does

When your agent uses it

• Clerk astro middleware
• Astro protected page
• Clerk island component
• Astro API route auth

Example prompts

• “/clerk-astro-patterns”

Requirements

• Node.js
• A credential in PUBLIC_CLERK_PUBLISHABLE_KEY
• A credential in CLERK_SECRET_KEY
• Pre-approved tools (allowed-tools): WebFetch

What it can do on your machine

Read from SKILL.md and the folder at commit e5554c5. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • WebFetch

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships script files (JavaScript and TypeScript), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • clerk.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • PUBLIC_CLERK_PUBLISHABLE_KEY
  • CLERK_SECRET_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clerk Astro Patterns loads about 822 tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~66

When it runs · the whole SKILL.md, loaded when a task matches

~822

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:102

  # .env

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from geekskai/blog at commit e5554c5, republished under its MIT licence (© geekskai). 206 words, ~822 tokens.

name

clerk-astro-patterns

description

Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering. Triggers on: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

allowed-tools

WebFetch

license

MIT

metadata.author

clerk

metadata.version

1.0.0

Request → clerkMiddleware() → SSR page → Astro.locals.auth()
                                ↓
                         Island (.client) → useAuth() hook

import { defineConfig } from 'astro/config'
import clerk from '@clerk/astro'

export default defineConfig({
  integrations: [clerk()],
  output: 'server',
})

import { clerkMiddleware, createRouteMatcher } from '@clerk/astro/server'

const isProtectedRoute = createRouteMatcher(['/dashboard(.*)'])

export const onRequest = clerkMiddleware((auth, context, next) => {
  if (isProtectedRoute(context.request) && !auth().userId) {
    return auth().redirectToSignIn()
  }
  return next()
})

---
const { userId, orgId } = Astro.locals.auth()
if (!userId) return Astro.redirect('/sign-in')
---

<h1>Dashboard</h1>

# .env
PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...
CLERK_SECRET_KEY=sk_...

© geekskai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 12 other files (references) in .agents/skills/clerk-astro-patterns of geekskai/blog.

• SKILL.md
• evals/evals.json
• references/api-routes.md
• references/astro-react.md
• references/island-components.md
• references/middleware.md
• references/ssr-pages.md
• templates/astro-basic-auth/astro.config.mjs
• templates/astro-basic-auth/package.json
• templates/astro-basic-auth/src/layouts/Layout.astro
• templates/astro-basic-auth/src/middleware.ts
• templates/astro-basic-auth/src/pages/index.astro
• templates/astro-basic-auth/tsconfig.json

Open the folder on GitHubat commit e5554c5