subgraph-skills

Subgraph Skills

Claude Code skills for creating, editing, analyzing, and migrating Amp-powered subgraphs.

Skills

• subgraph-migration – Migrate a traditional WASM/AssemblyScript subgraph to an Amp-powered subgraph

Installation

Start Claude Code, then run the following commands inside the session.

Add the marketplace from GitHub:

/plugin marketplace add edgeandnode/subgraph-skills

Then install the plugin:

/plugin install subgraph-skills

You can also browse and install interactively by running /plugin and navigating to the Discover tab.

Usage

Navigate to a subgraph project directory and invoke the skill directly:

/subgraph-migration

The skill also triggers automatically from natural language. Just ask Claude something like:

• "Help me migrate this subgraph to Amp"
• "Convert this subgraph to Amp"
• "Migrate to Amp"

The skill will:

1. Validate the subgraph directory (expects a subgraph.yaml with dataSources and schema.file)
2. Analyze and classify all entities and handlers
3. Generate SQL transformer queries for each handler
4. Determine the migration mode (single Amp subgraph or two-subgraph plan)
5. Write a complete migration plan to subgraph-migration.md in your project directory

You can also pass optional arguments to customize the migration:

> /subgraph-migration target network: base, use aggregations for stateful entities

Supported options via arguments:

• Target network/dataset override
• Whether to adopt aggregation patterns for stateful entities
• Specific data sources to migrate (partial migration)

Supported Networks

Network Aliases	Amp Network	Amp Dataset
mainnet, ethereum, ethereum-mainnet	ethereum-mainnet	edgeandnode/ethereum_mainnet
base, base-mainnet	base-mainnet	edgeandnode/base_mainnet
arbitrum, arbitrum-one	arbitrum-one	edgeandnode/arbitrum_one

Custom networks are supported — the skill will prompt you for the Amp dataset and network names.

License

MIT