backend-type-bridger
Syncs a local FastAPI OpenAPI file to TypeScript types and reads Firestore schema hints. Use when writing Vue composables against FastAPI or Firebase backends.
How do I install this agent skill?
npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill backend-type-bridgerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is safe. It is a local development utility for syncing FastAPI and Firestore schemas to TypeScript types. While it suggests using `curl` to fetch an OpenAPI schema, it explicitly requires the user to do this manually to a local file first and specifically blocks internal network fetching to prevent Server-Side Request Forgery (SSRF).
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Backend Type Bridger
When to use
- Frontend agent needs accurate API payload shapes
- Local
openapi.json(or another OpenAPI file under the project root) - Firestore rules or schema file exists for Firebase projects
Instructions
-
Ensure a local OpenAPI file at
openapi.json(project root). Prefer the scaffolded file. If the API is running and the file is missing/stale, export to disk first (do not pass a URL into this skill):curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json -
FastAPI types:
python scripts/sync_openapi.py --project-root <root>: writessrc/types/api.tsfrom localopenapi.jsononly (optional--openapi path/rel.json). -
Firebase:
python scripts/fetch_firestore_schema.py --project-root <root> -
Import generated types in composables: never guess field names. Refine generated interfaces if OpenAPI uses
$refheavily.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/heyeddi-com/heyeddi-skills/backend-type-bridger">View backend-type-bridger on skillZs</a>