add-portal-admin-api-mutation

Agent Skills › authgear/authgear-server › add-portal-admin-api-mutation

add-portal-admin-api-mutation

GitHub

指导在 Portal Admin 中添加 GraphQL mutation，包括读取 schema、创建文件、查询字段及运行类型生成脚本。

.claude/skills/add-portal-admin-api-mutation/SKILL.md authgear/authgear-server

Trigger Scenarios

需要添加新的 Portal Admin GraphQL mutation 修改 portal 目录下的 graphql 文件

Install

npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y

More Options

Non-standard path

npx skills add https://github.com/authgear/authgear-server/tree/main/.claude/skills/add-portal-admin-api-mutation -g -y

Use without installing

npx skills use authgear/authgear-server@add-portal-admin-api-mutation

指定 Agent (Claude Code)

npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -a claude-code -g -y

安装 repo 全部 skill

npx skills add authgear/authgear-server --all -g -y

预览 repo 内 skill

npx skills add authgear/authgear-server --list

SKILL.md

Frontmatter

{
    "name": "add-portal-admin-api-mutation",
    "description": "Add a Portal Admin GraphQL mutation under portal\/src\/graphql\/adminapi\/mutations.",
    "argument-hint": "<mutation name>"
}

Follow this skill when adding a Portal Admin GraphQL mutation.

Workflow

Read ./portal/src/graphql/adminapi/schema.graphql first.
Create the .graphql file under ./portal/src/graphql/adminapi/mutations.
Query all fields on the top-level entity unless the user explicitly says otherwise.
Avoid nested entities unless the user asked for them.
Run cd ./portal && npm run gentype after adding the file.