Menu
Regenerate TypeScript types from the backend OpenAPI spec for the portal. Use after adding or changing backend API endpoints, DTOs, or response shapes.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Generate a complete CRUD or read-only list page in the Angular portal with service, routing, and menu integration. Use when adding a new feature page to the portal.
Add a new notification provider (email, SMS, WhatsApp, push, voice) to the OsmoX API with service, consumer, queue wiring, and master provider seed.
Run lint, format, and build checks across the monorepo. Use when asked to check code quality, fix lint errors, or verify the build passes.
Create a git commit following project conventions. Use when asked to commit changes.
Create, run, or revert TypeORM database migrations. Use when modifying entities, adding columns, creating tables, or troubleshooting database schema issues.
Sync source markdown docs to the Mintlify documentation site. Use when source docs in apps/api/docs/ are added or updated, or when creating new docs-site pages.
| name | generate-api-types |
| description | Regenerate TypeScript types from the backend OpenAPI spec for the portal. Use after adding or changing backend API endpoints, DTOs, or response shapes. |
| allowed-tools | Bash, Read |
Regenerates apps/portal/src/app/core/types/api.types.ts from the running backend's Swagger spec.
The API server must be running at http://localhost:3000.
cd apps/api && npm run start:dev
Wait for the server to start, then verify Swagger is accessible:
curl -s http://localhost:3000/api/docs-json | head -1
cd apps/portal
npm run generate:api
This runs openapi-typescript http://localhost:3000/api/docs-json -o src/app/core/types/api.types.ts.
api.types.ts filesrc/app/core/models/api.model.ts:
import { components } from '../types/api.types';
export type Notification = components['schemas']['NotificationResponseDto'];
export type CreateApplicationInput = components['schemas']['CreateApplicationInput'];
api.model.ts — NOT directly from api.types.tsMyEntityFilters) — they must use snake_case to stay aligned with the wire format and the auto-generated response types. See apps/portal/CLAUDE.md § "snake_case applies to request shapes too".npx ng build to verify no type errors