custom-plugin-graphql
💡 Summary
A production-grade plugin for building GraphQL APIs with specialized agents and skills.
🎯 Target Audience
🤖 AI Roast: “Powerful, but the setup might scare off the impatient.”
Risk: Medium. Review: shell/CLI command execution; outbound network access (SSRF, data egress); filesystem read/write scope and path traversal. Run with least privilege and audit before enabling in production.
Install Now | Explore Agents | View Skills | Star this repo
What is this?
GraphQL Development Assistant is a production-grade Claude Code plugin with 7 specialized agents and 7 skills for building GraphQL APIs - from fundamentals to production deployment.
Table of Contents
Quick Start
Prerequisites
- Claude Code CLI v2.0.27+
- Active Claude subscription
Installation (Choose One)
# Step 1: Add the plugin /plugin marketplace add pluginagentmarketplace/custom-plugin-graphql # Step 2: Restart Claude Code # Close and reopen your terminal/IDE
# Clone the repository git clone https://github.com/pluginagentmarketplace/custom-plugin-graphql.git cd custom-plugin-graphql # Load locally /plugin load . # Restart Claude Code
Verify Installation
After restart, you should see 7 GraphQL agents available.
Features
| Feature | Description | |---------|-------------| | 7 Specialized Agents | GraphQL Fundamentals, Schema Design, Resolvers, Apollo Server, Apollo Client, Security, Codegen | | 7 Production Skills | Complete code examples, patterns, and troubleshooting guides | | 4 Interactive Commands | Learn, Assess, Browse Agents, View Roadmaps | | SASMP v1.3.0 | Full protocol compliance with agent-skill bonding | | Production Patterns | DataLoader, Federation, graphql-shield, TypeScript codegen |
Agents
7 Specialized GraphQL Agents
| # | Agent | Purpose | Expertise | |---|-------|---------|-----------| | 1 | 01-graphql-fundamentals | Core GraphQL educator | Types, queries, mutations, subscriptions, fragments | | 2 | 02-graphql-schema | Schema design architect | Naming conventions, pagination, error handling, interfaces | | 3 | 03-graphql-resolvers | Performance specialist | DataLoader, N+1 prevention, batching, context design | | 4 | 04-graphql-apollo-server | Server configuration expert | Apollo Server v4, plugins, federation, caching | | 5 | 05-graphql-apollo-client | React integration expert | Hooks, cache management, optimistic UI, subscriptions | | 6 | 06-graphql-security | Security architect | JWT auth, graphql-shield, rate limiting, validation | | 7 | 07-graphql-codegen | TypeScript code generation | Types, React hooks, configuration, fragments |
Invoke Agents
Task(subagent_type="graphql:01-graphql-fundamentals")
Task(subagent_type="graphql:02-graphql-schema")
Task(subagent_type="graphql:03-graphql-resolvers")
Task(subagent_type="graphql:04-graphql-apollo-server")
Task(subagent_type="graphql:05-graphql-apollo-client")
Task(subagent_type="graphql:06-graphql-security")
Task(subagent_type="graphql:07-graphql-codegen")
Skills
7 Production-Grade Skills
| Skill | Description | Complexity | Invoke |
|-------|-------------|------------|--------|
| graphql-fundamentals | Types, queries, mutations, subscriptions | Beginner | Skill("graphql-fundamentals") |
| graphql-schema-design | Naming, pagination, error patterns | Intermediate | Skill("graphql-schema-design") |
| graphql-resolvers | DataLoader, batching, N+1 prevention | Intermediate | Skill("graphql-resolvers") |
| graphql-apollo-server | Server v4, plugins, federation | Advanced | Skill("graphql-apollo-server") |
| graphql-apollo-client | React hooks, cache, optimistic UI | Intermediate | Skill("graphql-apollo-client") |
| graphql-security | Auth, rate limiting, validation | Advanced | Skill("graphql-security") |
| graphql-codegen | TypeScript types, React hooks | Intermediate | Skill("graphql-codegen") |
Skill Features
Each skill includes:
- Quick reference tables
- Production code examples
- Troubleshooting guides
- Debug checklists
- Related skills and agents
Commands
| Command | Description | Usage |
|---------|-------------|-------|
| /learn | Interactive GraphQL learning path | /learn [topic] |
| /assess | Knowledge assessment & skill gap analysis | /assess [topic] |
| /browse-agent | Explore 7 specialized GraphQL agents | /browse-agent [name] |
| /roadmap | Complete GraphQL learning roadmaps | /roadmap [path] |
Example Usage
# Start learning GraphQL /learn fundamentals # Assess your knowledge /assess # Browse available agents /browse-agent # View full-stack roadmap /roadmap full-stack
Architecture
Agent-Skill Bonding
Agent Skill (PRIMARY_BOND)
──────────────────────────────────────────────────
01-graphql-fundamentals ←→ graphql-fundamentals
02-graphql-schema ←→ graphql-schema-design
03-graphql-resolvers ←→ graphql-resolvers
04-graphql-apollo-server ←→ graphql-apollo-server
05-graphql-apollo-client ←→ graphql-apollo-client
06-graphql-security ←→ graphql-security
07-graphql-codegen ←→ graphql-codegen
Learning Path Dependencies
fundamentals (no prerequisites)
↓
schema-design (requires: fundamentals)
↓
resolvers (requires: fundamentals, schema)
↓
┌──┴──┐
↓ ↓
server client (requires: fundamentals)
│ │
↓ ↓
security codegen
Project Structure
custom-plugin-graphql/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace metadata
├── agents/ # 7 specialized agents
│ ├── 01-graphql-fundamentals.md
│ ├── 02-graphql-schema.md
│ ├── 03-graphql-resolvers.md
│ ├── 04-graphql-apollo-server.md
│ ├── 05-graphql-apollo-client.md
│ ├── 06-graphql-security.md
│ └── 07-graphql-codegen.md
├── skills/ # 7 production skills
│ ├── graphql-fundamentals/SKILL.md
│ ├── graphql-schema-design/SKILL.md
│ ├── graphql-resolvers/SKILL.md
│ ├── graphql-apollo-server/SKILL.md
│ ├── graphql-apollo-client/SKILL.md
│ ├── graphql-security/SKILL.md
│ └── graphql-codegen/SKILL.md
├── commands/ # 4 interactive commands
│ ├── learn.md
│ ├── assess.md
│ ├── browse-agent.md
│ └── roadmap.md
├── hooks/
│ └── hooks.json
├── README.md
├── CHANGELOG.md
└── LICENSE
Documentation
| Document | Description | |----------|-------------| | CHANGELOG.md | Version history | | CONTRIBUTING.md | How to contribute | | LICENSE | License information |
Metadata
| Field | Value | |-------|-------| | Version | 2.0.0 | | Last Updated | 2025-12-30 | | Status | Production Ready | | SASMP | v1.3.0 | | Agents | 7 | | Skills | 7 | | Commands | 4 |
Contributing
Contributions are welcome! Please read our Contributing Guide.
- Fork the repository
- Create your feature branch
- Follow SASMP v1.3.0 for new agents/skills
- Submit a pull request
Security
Important: This repository contains third-party code and dependencies.
- Always review code before using in production
- Check dependencies for known vulnerabilities
- Follow security best practices
- Report security issues privately via Issues
License
Copyright 2025 Dr. Umit Kacar & Muhsin Elcicek
Custom License - See LICENSE for details.
Contributors
Made with care for the Claude Code Community
Pros
- Comprehensive set of agents and skills.
- Production-ready features.
- Interactive commands for learning.
- Strong community support.
Cons
- Requires an active Claude subscription.
- Dependency on third-party code.
- Installation may be complex for beginners.
- Limited documentation on advanced features.
Related Skills
pytorch
S“It's the Swiss Army knife of deep learning, but good luck figuring out which of the 47 installation methods is the one that won't break your system.”
agno
S“It promises to be the Kubernetes for agents, but let's see if developers have the patience to learn yet another orchestration layer.”
nuxt-skills
S“It's essentially a well-organized cheat sheet that turns your AI assistant into a Nuxt framework parrot.”
Disclaimer: This content is sourced from GitHub open source projects for display and rating purposes only.
Copyright belongs to the original author pluginagentmarketplace.