golang-graphql Skill for Claude: What It Does and How to Install It

Makes Claude build GraphQL APIs in Go with gqlgen or graphql-go, from schema design to resolvers and subscriptions.

Installs: 37.8K; on skills.sh
Stars: 3.7K; on GitHub
Files: 4; besides SKILL.md
Updated: Nov 2026; last repo commit

This skill covers GraphQL servers in Go. It compares gqlgen (code generation, good for large schemas and federation) with graph-gophers/graphql-go (reflection, simpler builds), and warns off graphql-go/graphql.

Claude designs schemas with explicit nullability, batches database access to prevent N+1 queries and treats query complexity limits as required in production. It loads for GraphQL work and does not appear as a slash command.

Good for

Go developers building a GraphQL server
Teams fixing N+1 queries with DataLoaders
Anyone choosing between gqlgen and graphql-go

Install golang-graphql

Claude Code

Copy this prompt.

Install the golang-graphql skill in Claude Code. Run this command:

npx skills add https://github.com/samber/cc-skills-golang --skill golang-graphql

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports `github.com/99designs/gqlgen` or `github.com/graph-gophers/graphql-go`.

Sections in SKILL.md

Library Choice
Schema Design
Resolver Patterns
N+1 Prevention (DataLoaders)
Authentication and Authorization
Error Handling
Subscriptions
Performance and Safety
Common Mistakes
Deep Dives
Cross-References
References

Key facts

Author: samber
License: MIT
Installs on skills.sh: 37,785 (Nov 2, 2026)
GitHub stars: 3,749 for the whole samber/cc-skills-golang repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
What it includes: 5 files including SKILL.md: 3 reference guides and an evals/evals.json file
Needs: A Go project and the go command (SKILL.md lists go as a required binary)
Skill version: 0.2.2
Library version covered: 0.17.89
Starts: Loads on its own for GraphQL work in Go. It is not a slash command (user-invocable is false)
Works in: Claude Code, Codex or similar tools per the SKILL.md compatibility line. The README also names Gemini, Copilot, Antigravity and Cursor

What it includes

gqlgen vs graph-gophers vs graphql-go/graphql
gqlgen for large schemas and Apollo Federation, graph-gophers for small or medium schemas. It calls graphql-go/graphql one to avoid.
Try: “Add a GraphQL API to this Go service with gqlgen.”
Read · Library choice
Explicit nullability and ID scalars
Mark a field non-null only when the server can always return it.
Write · Schema design
Writing resolvers for both libraries
Reference guides: references/gqlgen.md and references/graphql-go.md. With gqlgen, the schema changes need go generate again, which rewrites generated files.
Write · Resolver patterns
DataLoaders batch database access
Batches repeated lookups inside resolvers.
Write · N+1 prevention
Authorization in resolvers and GraphQL error handling
Sections on authentication, authorization and error handling.
Write · Auth and errors
Realtime updates over GraphQL
Section on subscriptions with context propagation.
Write · Subscriptions
Query complexity limits and similar guards
Depth and parallelism limits, query allow-listing with persisted queries, and a note that unlimited nested queries can exhaust CPU and memory.
Write · Performance and safety
gqlgen client harness, gqltesting and httptest
Reference guide in references/testing.md.
Read · Testing

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It lists git and shell commands as allowed tools
The allowed-tools line covers any go, golangci-lint and git command (git:*), not just read ones. Keep Claude Code's permission prompts on for git commands that change history. github.com
It may fetch web pages or query Context7
It lists WebFetch and the Context7 tools as allowed. Library names and questions can leave your machine. Do not put secrets in prompts about this code. github.com
It lists curl as an allowed tool
The allowed-tools line includes Bash(curl:*), so Claude can send HTTP requests, for example to a local GraphQL endpoint. Check the URLs it uses. github.com
gqlgen setup installs a tool and generates code
references/gqlgen.md shows go run github.com/99designs/gqlgen init and go get -tool github.com/99designs/gqlgen@latest, then go tool gqlgen generate. These change go.mod and create or rewrite files. Review the diff. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode in SKILL.md. Use version control.
Talks to	WebFetch is listed as an allowed tool. Library lookups go to Context7 if the Context7 MCP server is installed (the skill uses it as a fallback)
Sign-in and keys	SKILL.md does not mention any account or key.
Scopes	Reads and edits files in your Go project SKILL.md lists these as allowed tools: go, golangci-lint, git, godig and gopls commands, curl Can run curl commands (listed as an allowed tool) May run go generate for gqlgen, which rewrites generated files references/gqlgen.md shows go run gqlgen init and go get -tool gqlgen@latest, which add a dependency and generate files

Questions

What does the golang-graphql skill do?

It teaches Claude to build GraphQL APIs in Go with gqlgen or graphql-go. That covers schema design, resolvers, DataLoaders, auth, errors, subscriptions and limits.

How do I install golang-graphql?

Use the install box at the top of this page. It is a text skill with reference guides, so there is nothing to compile. Start a new session so it loads, then work in a Go project.

gqlgen or graphql-go?

The skill picks gqlgen when you need Apollo Federation, a large schema (100+ types) or generated stubs. It picks graph-gophers/graphql-go for small or medium schemas and a simple build pipeline.

Why is there no slash command for it?

SKILL.md sets user-invocable to false, and the repo's CLAUDE.md says such skills trigger on their own from context instead of being slash commands.

Does it need other skills from the same repo?

SKILL.md does not list any other skill as required. SKILL.md points to related skills in samber/cc-skills-golang for side topics, and the README says installing only a subset gives a partial and possibly inconsistent view of the guidelines. For best results it recommends installing the general-purpose Go skills together.

Is golang-graphql safe?

Mostly, for your own Go projects. It is instructions plus reference files, and it lets Claude edit files and run go and git commands. Review diffs, keep the project under version control and avoid secrets in prompts.

Does golang-graphql work in Codex, Cursor or the Claude app?

It is designed for Claude Code, Codex or a similar tool, and the README says the skills are built for Claude Code, Codex, Gemini, Copilot, Antigravity and Cursor. Because it works on your Go files and uses the go command, use a coding tool rather than the Claude app.

Information

updated Nov 2, 2026

Repository: samber/cc-skills-golang
Folder: skills/golang-graphql

samber/cc-skills-golang skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4