Skill Library

Clerk Auth Setup (Next.js)

Wire Clerk into a Next.js App Router app: provider, middleware, protected routes, and reading the user in server code without throwing.

Neon + Drizzle Migrations

Model a schema with Drizzle, generate and apply migrations against Neon Postgres, and keep local and production in sync without data loss.

Neon Serverless Client Patterns

Use the Neon serverless HTTP driver in a Next.js app that must build without a database: lazy connection, a guarded client, and pooled vs direct URL choices.

Clerk Dev vs Prod Gotchas

Survive domain-locked production Clerk keys in local dev: why auth() throws, the middleware bypass, and a getUserId helper that returns null instead of 500.

API Key Auth Design (Hash-Only)

Issue and verify programmatic API keys without ever storing the secret: show once, persist only a sha256 hash plus a display prefix, verify by hashing the bearer token.

Deploy & Ops5

Vercel Deploy Debugging

Diagnose the common ways a Next.js build passes locally but fails on Vercel: pnpm build gates, type errors, env vars, and uncommitted files.

Oxlint as a Fast CI Gate

Add oxlint as a fast, zero-error lint gate alongside a Next.js project: config, an autofix pass, and the errors-fail warnings-advisory split that keeps CI honest.

GitHub Actions for Agent-Written Code

Gate agent-authored changes in CI: verify the committed tree not the working tree, reproduce the deploy's install and type gate exactly, and fail fast on drift.

Request Tracing with Spans

Instrument a request with timed spans and one durable trace row: best-effort writes that never throw into the caller, per-thread grouping, and a waterfall the UI can render.

Verifying the Committed Tree Before Push

Catch the agent failure mode where a commit imports an uncommitted file: typecheck an isolated worktree of HEAD, not the dirty working tree, before pushing to main.

Agents & MCP13

Agent Fleet Coordination

Coordinate a fleet of subagents end to end: the orchestrator, finder, and verifier roles, single-writer file ownership, and a collect-then-apply harvest loop that merges results without collisions.

MCP Server Builder

Build a production MCP server as a Next.js route with mcp-handler: design tools as prompt engineering, wire strict zod schemas and Bearer auth, and evaluate every tool so the model actually calls it.

Progressive Disclosure for MCP

Expose a collection over MCP with the three-tier lean index -> manifest -> item pattern so an agent spends context only on what it opens. Covers each tier's payload shape, naming symmetry, and when to collapse the middle tier.

How to Write a Great Skill

Skill Testing Checklist

LLM Engineering6

Single-File App Generation

Prompt an LLM to emit a complete, self-contained HTML app and run it safely in a sandboxed iframe. Covers the output contract (one file, pinned CDN versions, module scripts), the sandbox and CSP for untrusted output, size caps, and the blank-frame failure modes.

Refusal and Fallback Handling

Design LLM features that degrade gracefully when the model refuses, returns malformed output, or times out, instead of showing users a raw error.

Prompt Caching Optimization

Cut latency and token cost by structuring prompts so the stable prefix (system, tools, long context) is cached and only the tail changes per request.

Structured Output Extraction

Turn messy text into reliable typed data with an LLM: a strict schema, tool or JSON mode, validation, and a repair loop that never ships bad shapes.

Vercel AI Gateway Integration

Route every model through the Vercel AI Gateway with the AI SDK: one key, plain string model ids, a client-safe whitelist, and the gotchas that only bite in production.

SEO & Content2

SEO

Content Pipeline

Take a topic or a published video through research, drafting, SEO structure, and a pre-publish checklist to a shipped, source-linked, decision-intent post that ranks and stays fair to every tool covered.

SEO

SEO Decision-Intent Posts

Write comparison, pricing, and alternatives content that ranks and stays fair: real research, primary-source links, structured FAQ, and honest verdicts.

Design & UI5

Dashboard Design (Vercel + shadcn)

Build member and dashboard surfaces in the softer Vercel/shadcn idiom (rounded, neutral, generous spacing) while keeping them distinct from the hard-edged square marketing site. Covers tokens and component patterns.

shadcn Component Adaptation

Install shadcn/ui components and adapt them to a strict design contract: strip defaults that fight your system, keep the accessibility, ship consistent variants.

Streamdown Chat Rendering

Render streaming LLM markdown safely in a chat UI with Streamdown: incomplete-token handling, a custom component map, and matching a strict design contract.

Hyperframes

Entry skill for HeyGen's HyperFrames, a framework that renders video from HTML compositions. Routes any request to make, edit, animate, or render a video or motion graphic to the right HyperFrames workflow and domain skill.

Remotion Best Practices

Official best practices from the Remotion team for creating videos in React: project setup, animating with useCurrentFrame and interpolate, timing, assets, and rendering rules.

Billing4

Credit-Metered AI Endpoints

Monetize AI endpoints with a prepaid credit balance: the deduct-on-success ordering, an atomic single-UPDATE spend that cannot go negative under concurrency, a consistent 401/402/429 error envelope, rate limiting, an append-only ledger, and an owner bypass.

Credit Metering for SaaS

Meter AI features with a universal credit balance: per-action cost table, an atomic debit, owner bypass, and a clean 402 path that routes to pricing.

Autumn Credit Billing

Wire Autumn (Stripe billing layer) for a universal credit balance: Clerk userId as the customer id, hosted checkout, Svix-signed webhooks, and grant-on-verify.