new-service
SkillDev toolsScaffold 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the new-service skill
What this skill tells your AI
The instructions your AI receives, as published by gaia-react/gaia in .claude/skills/new-service/SKILL.md and read by ahel’s review.
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
Signals
- GitHub stars
- 23
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
new-service- Source
- github.com/gaia-react/gaia