Agent Skills › authgear/authgear-server › generate-schemas-and-gentype

generate-schemas-and-gentype

GitHub

指导在更新 authgear-server GraphQL schema 或前端类型时，通过 make export-schemas 和 npm run gentype 命令重新生成文件，禁止手动编辑。

.claude/skills/generate-schemas-and-gentype/SKILL.md authgear/authgear-server

Trigger Scenarios

修改了 GraphQL schema 文件需要更新生成的前端 TypeScript 类型

Install

npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -g -y

More Options

Non-standard path

npx skills add https://github.com/authgear/authgear-server/tree/main/.claude/skills/generate-schemas-and-gentype -g -y

Use without installing

npx skills use authgear/authgear-server@generate-schemas-and-gentype

指定 Agent (Claude Code)

npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -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": "generate-schemas-and-gentype",
    "description": "Use when updating GraphQL schema or generated frontend types in authgear-server. Always regenerate checked-in schema\/type artifacts with make export-schemas and portal npm run gentype instead of editing generated files by hand."
}

Generate Schemas and Types

Use this skill when a change touches GraphQL schema files or generated frontend types.

Workflow

Make the source change in Go or GraphQL documents first.
Regenerate backend schema artifacts with make export-schemas.
Only after the schema files have been updated, regenerate portal GraphQL types with cd portal && npm run gentype.
Verify the affected packages with the narrowest relevant tests or typecheck.

Rules

Do not hand-edit generated schema or type files when a generator exists.
Keep the generated outputs in the same commit as the source change.
Always run make export-schemas before npm run gentype for schema-related changes.
If the generator rewrites more files than expected, inspect the diff before proceeding.