# Graphql Docs

> >

- **Type:** Skill
- **Install:** `agentstack add skill-pledgeandgrow-pledge-skills-graphql`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pledgeandgrow](https://agentstack.voostack.com/s/pledgeandgrow)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [pledgeandgrow](https://github.com/pledgeandgrow)
- **Source:** https://github.com/pledgeandgrow/pledge-skills/tree/main/skills/graphql

## Install

```sh
agentstack add skill-pledgeandgrow-pledge-skills-graphql
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GraphQL

GraphQL is a query language for APIs and a runtime for fulfilling those queries with existing data. It provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need, makes it easier to evolve APIs over time, and enables powerful developer tools.

**Specification**: [spec.graphql.org/draft](https://spec.graphql.org/draft/)

---

## Quick Reference

| Topic | File |
|------|------|
| Introduction & Core Concepts (type system, queries, versionless evolution) | `introduction.md` |
| Schemas & Types (SDL, object types, scalars, enums, interfaces, unions, input types, directives) | `schema.md` |
| Queries (fields, arguments, aliases, variables, fragments, inline fragments, directives) | `queries.md` |
| Mutations (create, update, delete, input objects, serial execution) | `mutations.md` |
| Subscriptions (real-time, pub/sub, WebSocket transport, scaling) | `subscriptions.md` |
| Validation (validation rules, error detection, common invalid queries) | `validation.md` |
| Execution (resolvers, context, async, scalar coercion, list resolvers) | `execution.md` |
| Response Format (data, errors, extensions, request vs field errors, status codes) | `response.md` |
| Introspection (__schema, __type, querying the schema itself) | `introspection.md` |
| Best Practices (thinking in graphs, HTTP serving, auth, pagination, errors, caching, security, federation, schema governance) | `best-practices.md` |

---

## Core Concepts

- **Schema**: The type system that describes all available data and operations
- **Query**: Read operation that traverses fields to fetch exactly what's needed
- **Mutation**: Write operation that modifies data (executed serially)
- **Subscription**: Long-lived operation for real-time data updates
- **Resolver**: Function that provides data for each field
- **Type System**: Scalars, objects, enums, interfaces, unions, input types, lists, non-null
- **SDL**: Schema Definition Language — language-agnostic way to describe schemas
- **Introspection**: Ability to query the schema itself via `__schema` and `__type`

---

## Official Documentation

- [GraphQL Learn](https://graphql.org/learn/)
- [GraphQL Specification](https://spec.graphql.org/draft/)
- [GraphQL Code](https://graphql.org/code/)
- [GraphQL FAQ](https://graphql.org/faq/)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pledgeandgrow](https://github.com/pledgeandgrow)
- **Source:** [pledgeandgrow/pledge-skills](https://github.com/pledgeandgrow/pledge-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pledgeandgrow-pledge-skills-graphql
- Seller: https://agentstack.voostack.com/s/pledgeandgrow
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.