Fix OpenAPI Schema Drift
SkillDev toolsFix OpenAPI schema drift between backend and frontend. Use when CI fails with "API Schema Drift" or "API client is out of date", or after adding/changing backend controllers or DTOs.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Fix OpenAPI Schema Drift skill
What this skill tells your AI
The instructions your AI receives, as published by ayunis-core/ayunis-core in .claude/skills/fix-schema-drift/SKILL.md and read by ahel’s review.
Prerequisites
The dev stack must be running (./dev status). Start with ./dev up if needed.
Fix
cd ayunis-core-frontend
pnpm run openapi:update
Then stage and commit the changed files with gt modify or gt create.
Notes
- Never hand-edit generated files — always regenerate via
pnpm run openapi:update pnpm run openapi:updaterunsopenapi:fetch→openapi:format→openapi:generate. The format step (prettier --write) is required:fetch-openapi-schema.jswrites viaJSON.stringify(_, null, 2), which puts every short array on multiple lines, but the canonical on-disk format is prettier's compact-when-fits style. Without the format step, schema regens produce ~2000 lines of whitespace-only churn.- If you ever need to format the schema by itself:
pnpm run openapi:format - Formatting-only changes are normal — still commit them to keep CI green
Signals
- GitHub stars
- 33
- Forks
- 3
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
fix-schema-drift- Source
- github.com/ayunis-core/ayunis-core