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開発

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

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.

主な機能

01Automate validation via GitHub Actions and pre-commit hooks

02Enforce query depth and complexity limits to prevent performance degradation

03Validate GraphQL operations against local or remote schemas

0472 GitHub stars

05Extract and validate operations directly from TypeScript and JavaScript files

06Support for Apollo Federation (v1/v2) and AWS AppSync directives

ユースケース

01CI/CD integration to prevent invalid GraphQL operations from being merged

02Enforcing API security by limiting query depth and alias counts

03Auditing legacy codebases to find orphaned fragments or breaking schema changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han graphql-inspector-validate

For use in Claude.ai and ChatGPT

Download Skill