Use when a user wants to generate a playbook-style `admin.yaml` from a SAFRS FastAPI `jsonapi.json` or OpenAPI schema, especially when reusing the `openapi_to_admin_yaml.py` generator in other projects.
Use this skill when the task is: take a SAFRS FastAPI OpenAPI schema and generate an admin.yaml file for the admin frontend.
The bundled generator lives at scripts/openapi_to_admin_yaml.py.
/api/... and JSON:API collection responses that reference *DocumentCollection schemas.python skills/openapi-to-admin-yaml/scripts/openapi_to_admin_yaml.py path/to/jsonapi.json -o path/to/admin.yaml
admin.yaml with static top-level settings, reuse it as a template:python skills/openapi-to-admin-yaml/scripts/openapi_to_admin_yaml.py path/to/jsonapi.json --template-admin path/to/admin.yaml -o path/to/admin.yaml
user_key values look sensibletab_groups match the API model/api/... routes are skipped.user_key.Open scripts/openapi_to_admin_yaml.py only if the target project uses a different SAFRS OpenAPI contract or the generated admin.yaml shape needs to change.
The script is designed for the raw playbook-style admin.yaml used in this repo.