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 管理端 GraphQL 查询接口在 adminapi/query 目录下创建 .graphql 文件

安装

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.