Can I use this in my GitHub Actions?

Absolutely. The skill provides specific patterns and configuration examples for integrating GraphQL Inspector into CI/CD workflows to catch errors during pull requests.

Can I validate GraphQL operations inside TypeScript files?

Yes, this skill supports extracting and validating operations from template literals in .ts, .tsx, .js, and .jsx files using standard GraphQL tags.

What happens if a field is missing from my schema?

The validation command will identify 'Unknown Field' errors, allowing you to fix the operation or update the schema before the code reaches production.

Does it support Apollo Federation?

Yes, it includes specific flags for both Apollo Federation V1 and V2, as well as support for AWS AppSync directives.

How does this help with API performance?

It allows you to set limits on query depth, alias counts, and complexity scores to prevent expensive or malicious queries from hitting your server.

GraphQL Operation Validation

Name: GraphQL Operation Validation
Author: TheBushidoCollective

byTheBushidoCollective

•

API Development

Validates GraphQL operations against schemas to ensure correctness and enforce performance constraints.

About

This skill provides expert knowledge for using the GraphQL Inspector's validate command to audit queries, mutations, and fragments against a target schema. It allows developers to catch runtime errors early by checking for undefined fields, type mismatches, and invalid fragments, while also enforcing security and performance rules such as query depth limits, alias counts, and complexity scores. It is particularly useful for maintaining API integrity in large-scale projects, supporting Apollo Federation, AWS AppSync, and seamless integration with CI/CD pipelines.

Key Features

Automate validation via GitHub Actions and pre-commit hooks
Enforce query depth and complexity limits to prevent performance degradation
Validate GraphQL operations against local or remote schemas
72 GitHub stars
Extract and validate operations directly from TypeScript and JavaScript files
Support for Apollo Federation (v1/v2) and AWS AppSync directives

Use Cases

CI/CD integration to prevent invalid GraphQL operations from being merged
Enforcing API security by limiting query depth and alias counts
Auditing legacy codebases to find orphaned fragments or breaking schema changes

About

Key Features

Automate validation via GitHub Actions and pre-commit hooks
Enforce query depth and complexity limits to prevent performance degradation
Validate GraphQL operations against local or remote schemas
72 GitHub stars
Extract and validate operations directly from TypeScript and JavaScript files
Support for Apollo Federation (v1/v2) and AWS AppSync directives

Use Cases

CI/CD integration to prevent invalid GraphQL operations from being merged
Enforcing API security by limiting query depth and alias counts
Auditing legacy codebases to find orphaned fragments or breaking schema changes