sk-api

What problem does it solve?

This Skill standardizes how you write authenticated mutations and Next.js API route handlers so your TimeKast Starter Kit codebase stays consistent, validated, and reliably revalidated.

Core Features & Use Cases

• Action wrappers for mutations: Use withAuth and withSelf to enforce auth/RBAC, validate inputs with Zod, inject userId, and normalize failures into ActionResult.
• Discriminated return contract: Use ActionResult and ActionError to keep client handling predictable and user-facing error messages consistent.
• Kit-canonical API route conventions: Write app/api/*/route.ts handlers with inline validation, inline Response.json error shapes, structured logging, and async params.

Quick Start

Use the sk-api Skill when you are creating a new mutation Server Action file under src/lib/actions and a new app/api/*/route.ts handler so you can follow the kit’s wrapper and response conventions.