add-portal-admin-api-query

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

add-portal-admin-api-query

GitHub

指导在Portal Admin中新增GraphQL查询的标准流程，包括读取Schema、创建文件、处理分页及生成类型。

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

Trigger Scenarios

需要添加Portal Admin GraphQL查询修改或扩展Admin API查询接口

Install

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

More Options

Non-standard path

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

Use without installing

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

指定 Agent (Claude Code)

npx skills add authgear/authgear-server --skill add-portal-admin-api-query -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-query",
    "description": "Add a Portal Admin GraphQL query under portal\/src\/graphql\/adminapi\/query.",
    "argument-hint": "<query name>"
}

Follow this skill when adding a Portal Admin GraphQL query.

Workflow

Read ./portal/src/graphql/adminapi/schema.graphql first.
Create the .graphql file under ./portal/src/graphql/adminapi/query.
Include cursor, pageInfo, and totalCount when the query supports pagination and the user did not ask to omit them.
Query the fields of the entity itself, but avoid nested entities unless the user asked for them.
Run cd ./portal && npm run gentype after adding the file.