add_portal_admin_api_mutation

What problem does it solve?

This Skill ensures every Portal Admin GraphQL mutation is created in line with the schema, preventing ad-hoc or inconsistent mutation definitions.

Core Features & Use Cases

• Schema-first mutation creation: Read portal/src/graphql/adminapi/schema.graphql before authoring the new operation so you only use existing fields.
• Guided mutation placement: Create the .graphql file under portal/src/graphql/adminapi/mutations, query all top-level fields, and avoid nested entities unless explicitly requested.
• Type generation handshake: Run npm run gentype from the portal directory after adding the mutation to keep generated types in sync. Use case: When adding a Portal Admin mutation for a new admin workflow, follow the schema and generation steps to keep the API consistent.

Quick Start

Add a new Portal Admin mutation file under portal/src/graphql/adminapi/mutations after reviewing the schema.graphql and finish by running npm run gentype from the portal directory.