New service
Scaffold a new API service with request functions, Zod schemas, URL constants, and optional MSW mock handlers. Use this skill whenever the user asks to "add a service", "create the projects API", "scaffold a new GAIA service", "wire up CRUD for users", or anything implying a new folder under `app/services/gaia/{name}/` with parsers/types/requests + matching `test/mocks/{name}/` collections.From its SKILL.md
npx -y skills add gaia-react/gaia --skill new-serviceAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 2 commands, including `.gaia/cli/gaia scaffold service <name> --endpoints "..." --schema "..." [--mocks]` and 1 more.
SKILL.md
1.3 KB, 254 tokens by cl100k_base, as published. Nobody here has run it
new-service
Trigger: user asks to scaffold an API service.
Workflow
- Confirm: name (kebab), endpoints, schema (
name:typepairs), with mocks? - Run:
.gaia/cli/gaia scaffold service <name> --endpoints "..." --schema "..." [--mocks] - Verify:
pnpm typecheckclean; if--mocks, run a single MSW round-trip in a vitest test. - Wire the service into the consuming page/hook (CLI does not do this, manual).
Flags
--endpoints "get,post,put,delete", required (subset of get/post/put/delete)--schema "id:string,name:string,status:enum(active,archived)", required--mocks, also emit MSW mock collection--json, emitScaffoldResultJSON
Schema types: string, number, boolean, datetime, enum(a,b,...). Append ? for optional.
See
wiki/concepts/API Service Pattern.md, pattern source of truth.claude/rules/api-service.md, quick pointer
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.