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 查询修改或扩展前端管理界面的数据获取逻辑

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.