How do I install the Thegraph skill?

Run npx skillmds@latest add tomevault-io/thegraph in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Thegraph safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Thegraph?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Thegraph free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Thegraph?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Thegraph by tomevault-io — Agent Skill

Name: Thegraph
Author: tomevault-io

File contents

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

Topic	Description	Reference
Substreams	Parallel indexing, Rust/WASM, multi-chain, multi-sink	features-substreams
Substreams Sinks	SQL, PubSub, stream, KV; official vs community	features-substreams-sinks

External Links

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: thegraphdescription: Use when working with the Graph — subgraph manifest, schema, mappings, GraphQL API, templates, Substreams, and performance practices for agent-driven indexing.---> Skill based on The Graph docs (graphprotocol/docs), generated 2026-02-09. Official docs: https://thegraph.com/docsThe 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](references/core-subgraph-manifest.md) || Schema | Entities, scalars, relationships, @derivedFrom, fulltext | [core-schema](references/core-schema.md) || Mappings | AssemblyScript handlers, graph-ts, codegen, store API | [core-mappings](references/core-mappings.md) || GraphQL API | Queries, filtering, pagination, sorting, time-travel | [core-graphql-api](references/core-graphql-api.md) || Subgraph ID vs Deployment ID | When to use which for querying; version pinning | [core-deployment-id-vs-subgraph-id](references/core-deployment-id-vs-subgraph-id.md) |## Best Practices| Topic | Description | Reference ||-------|-------------|-----------|| Performance | Avoid eth_calls, immutable entities, Bytes ids, @derivedFrom, pruning | [best-practices-performance](references/best-practices-performance.md) || Grafting & Hotfix | Reuse indexed data for hotfix deployment; when to use and avoid | [best-practices-grafting-hotfix](references/best-practices-grafting-hotfix.md) || Timeseries & Aggregations | @entity(timeseries), @aggregation, intervals, dimensions | [best-practices-timeseries](references/best-practices-timeseries.md) || Querying | Static queries, variables, @include/@skip, batching, fragments | [best-practices-querying](references/best-practices-querying.md) |## Features### Subgraph Features| Topic | Description | Reference ||-------|-------------|-----------|| Data Source Templates | Dynamic contracts, factory pattern, create/createWithContext | [features-data-source-templates](references/features-data-source-templates.md) || Deployment & Publishing | Deploy to Studio, publish to network, CLI, GRT signal | [features-deployment-publishing](references/features-deployment-publishing.md) || Querying from Application | Endpoints, graph-client, Apollo, URQL, API keys | [features-querying-from-application](references/features-querying-from-application.md) || Unit Testing (Matchstick) | graph test, describe/test, assertions, mocking, coverage | [features-unit-testing](references/features-unit-testing.md) || Subgraph Composition | Combine up to 5 source subgraphs; immutable entities, same chain | [features-subgraph-composition](references/features-subgraph-composition.md) || Subgraph Linter | Static analysis: entity overwrite, null safety, undeclared eth_calls | [features-subgraph-linter](references/features-subgraph-linter.md) || Debug Forking | Fork remote store at block X for fast local debugging | [features-debug-forking](references/features-debug-forking.md) || Graph Node Dev (gnd) | Local node with optional IPFS, auto Postgres, --watch | [features-graph-node-dev](references/features-graph-node-dev.md) |### Indexing| Topic | Description | Reference ||-------|-------------|-----------|| Substreams | Parallel indexing, Rust/WASM, multi-chain, multi-sink | [features-substreams](references/features-substreams.md) || Substreams Sinks | SQL, PubSub, stream, KV; official vs community | [features-substreams-sinks](references/features-substreams-sinks.md) |## External Links- [The Graph Docs](https://thegraph.com/docs)- [graphprotocol/docs GitHub](https://github.com/graphprotocol/docs)- [graph-tooling (graph-ts)](https://github.com/graphprotocol/graph-tooling)- [Substreams docs](https://docs.substreams.dev)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/hairyf) — claim your Tome and manage your conversions.

Frequently asked questions

Thegraph