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

触发场景

需要添加新的 Portal Admin GraphQL 查询修改或扩展 Portal Admin API 数据获取逻辑

安装

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

更多选项

非标准路径

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

不安装直接使用

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.