Skill based on The Graph docs (graphprotocol/docs), generated 2026-02-09. Official docs: https://thegraph.com/docs
The Graph indexes blockchain data into queryable subgraphs. Subgraphs are defined by a manifest (subgraph.yaml), a GraphQL schema, and AssemblyScript mappings; they are queried via GraphQL. Substreams provide parallel, multi-chain indexing with multiple sinks.
Core References
| Topic | Description | Reference |
|---|
| Subgraph Manifest | Data sources, event/call/block handlers, indexer hints | core-subgraph-manifest |
| Schema | Entities, scalars, relationships, @derivedFrom, fulltext | core-schema |
| Mappings | AssemblyScript handlers, graph-ts, codegen, store API | core-mappings |
| GraphQL API | Queries, filtering, pagination, sorting, time-travel | core-graphql-api |
| Subgraph ID vs Deployment ID | When to use which for querying; version pinning | core-deployment-id-vs-subgraph-id |
Best Practices
| Topic | Description | Reference |
|---|
| Performance | Avoid eth_calls, immutable entities, Bytes ids, @derivedFrom, pruning | best-practices-performance |
| Grafting & Hotfix | Reuse indexed data for hotfix deployment; when to use and avoid | best-practices-grafting-hotfix |
| Timeseries & Aggregations | @entity(timeseries), @aggregation, intervals, dimensions | best-practices-timeseries |
| Querying | Static queries, variables, @include/@skip, batching, fragments | best-practices-querying |
Features
Subgraph Features
| Topic | Description | Reference |
|---|
| Data Source Templates | Dynamic contracts, factory pattern, create/createWithContext | features-data-source-templates |
| Deployment & Publishing | Deploy to Studio, publish to network, CLI, GRT signal | features-deployment-publishing |
| Querying from Application | Endpoints, graph-client, Apollo, URQL, API keys | features-querying-from-application |
| Unit Testing (Matchstick) | graph test, describe/test, assertions, mocking, coverage | features-unit-testing |
| Subgraph Composition | Combine up to 5 source subgraphs; immutable entities, same chain | features-subgraph-composition |
| Subgraph Linter | Static analysis: entity overwrite, null safety, undeclared eth_calls | features-subgraph-linter |
| Debug Forking | Fork remote store at block X for fast local debugging | features-debug-forking |
| Graph Node Dev (gnd) | Local node with optional IPFS, auto Postgres, --watch | features-graph-node-dev |
Indexing
External Links