new-service

Scaffold a Fastify and Prisma backend service in a monorepo.

1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill new-service-mattbutlerengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-service
Source: https://github.com/mattbutlerengineering/mattbutlerengineering/tree/main/.claude/skills/new-service
Command: npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill new-service-mattbutlerengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting a new Fastify + Prisma backend service usually requires a lot of repetitive setup work across code, tests, configuration, and monorepo wiring.

Core Features & Use Cases

  • Service scaffolding by existing patterns: Creates a new services/<name> backend that matches the structure and conventions used by the existing users, agent, and reservations services.
  • Fastify app bootstrap with health and schemas: Generates the Fastify entrypoints, route registration, schema registration, and a standard GET /health endpoint.
  • Prisma foundation and test coverage: Adds a Prisma schema, local environment variables, Vitest configuration, and verification steps for linting, typechecking, and tests.
  • Monorepo integration updates: Provides a post-scaffold checklist to update Turborepo triggers, CLAUDE context/port tables, and create a service-specific CLAUDE.md.

Quick Start

Tell the assistant: Scaffold a new Fastify + Prisma service named payments on port 3005 with auth required.

Frequently Asked Questions about new-service

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

FAQPage Schema
How do I scaffold a Fastify and Prisma backend service?

Scaffolding a Fastify and Prisma backend service involves generating the service directory, TypeScript configuration, app bootstrap, health endpoints, route registration, and baseline Prisma schema setup automatically to match existing monorepo conventions.

What is included in a standard Fastify app bootstrap for a new API?

A standard Fastify app bootstrap includes route registration, schema registration, a GET /health endpoint, local environment variables, and baseline Vitest configuration for typechecking and testing.

Can I add JWT authentication to a new Fastify service during scaffolding?

Yes, you can optionally wire JWT authentication into the new Fastify service during scaffolding using the @mbe/auth package and the jose library for token verification.

Does this scaffolding tool work with Turborepo monorepos?

Yes, the tool is designed for Turborepo monorepos and provides a post-scaffold checklist to update Turborepo triggers, context port tables, and create service-specific CLAUDE documentation.

How do I set up Prisma schema and Vitest tests for a new backend API?

Setting up Prisma schema and Vitest tests happens automatically during scaffolding, which generates the Prisma schema file, local environment variables, and Vitest configuration with verification steps for linting and typechecking.

What are the limitations of scaffolding a backend service inside an existing monorepo?

The main limitation is that manual follow-up monorepo configuration is required after scaffolding, including updating Turborepo deployment triggers, context port tables, and adding service-specific CLAUDE.md documentation.