refresh-tarkovdev-schema

Fetch the tarkov.dev GraphQL schema and regenerate the Go client.

1|1|Updated Dec 16, 2023
One-click install
npx skills add https://github.com/sjtw/tarkov-build-optimiser --skill refresh-tarkovdev-schema
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-tarkovdev-schema
Source: https://github.com/sjtw/tarkov-build-optimiser/tree/main/.cursor/skills/refresh-tarkovdev-schema
Command: npx skills add https://github.com/sjtw/tarkov-build-optimiser --skill refresh-tarkovdev-schema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping the tarkov.dev GraphQL schema aligned with the live API and regenerating the corresponding Go client prevents runtime errors from missing fields and type changes.

Core Features & Use Cases

  • Schema synchronization: fetches the latest schema from tarkov.dev.
  • Code generation: regenerates the Go client code to reflect schema updates.
  • Validation: builds and tests to ensure compatibility after updates.

Quick Start

Run the task to fetch the latest schema and regenerate the Go client.

Frequently Asked Questions about refresh-tarkovdev-schema

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I regenerate a Go client from a GraphQL schema?

To regenerate a Go client from a GraphQL schema, fetch the latest tarkov.dev schema, run code generation to update types and fields, and verify builds to maintain API compatibility.

Why does my Go client fail when the GraphQL API adds new fields?

A Go client fails when schema changes introduce new fields or types. Regenerating the client code from the updated tarkov.dev GraphQL schema resolves these runtime errors by syncing local types.

What is the best way to sync tarkov.dev schema changes with my project?

The best way to sync tarkov.dev schema changes is to fetch the latest schema, regenerate the Go client code to reflect updates, and run builds to ensure compatibility.

When do I need to update my GraphQL schema during API version upgrades?

You need to update your GraphQL schema during API version upgrades, schema migrations, or when tarkov.dev adds new fields your project relies on to prevent missing field errors.

Does regenerating a Go client validate API compatibility automatically?

Yes, regenerating a Go client validates API compatibility automatically by fetching the latest tarkov.dev schema, updating the code, and running builds and tests to verify updates.

What happens if I don't regenerate code after a GraphQL schema migration?

If you don't regenerate code after a GraphQL schema migration, your project will experience runtime errors from missing fields and type changes that no longer match the live tarkov.dev API.