Scalable Message-Passing Quantum Graph Neural Networks methodology — building quantum GNNs with message passing, permutation equivariance, and Weisfeiler-Leman hierarchy placement. Enables pre-training on small graphs and cost-effective readout as graphs grow.
Scanned 9/11/2026
Install to Claude Code
npx -y skills add hiyenwong/ai_collection --skill scalable-mp-quantum-gnn --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Scalable Mp Quantum Gnn?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/hiyenwong-scalable-mp-quantum-gnn)More formats (shields.io, HTML) on the badges page.
---
name: scalable-mp-quantum-gnn
description: Scalable Message-Passing Quantum Graph Neural Networks methodology — building quantum GNNs with message passing, permutation equivariance, and Weisfeiler-Leman hierarchy placement. Enables pre-training on small graphs and cost-effective readout as graphs grow.
category: quantum
tags:
- quantum-machine-learning
- graph-neural-network
- message-passing
- weisfeiler-leman
- quantum-algorithms
arxiv: "2606.26873"
date: "2026-06-26"
---
# Scalable Message-Passing Quantum Graph Neural Networks
## Trigger Conditions
Use this skill when:
- Building quantum graph neural networks (QGNNs) for relational data
- Need theoretical expressivity guarantees (Weisfeiler-Leman hierarchy)
- Want to pre-train on small graph instances before scaling to larger graphs
- Working with graph problems: molecular property prediction, TSP, graph classification
- Classical message passing GNNs fail to separate certain graph structures
- Need permutation-equivariant quantum models
## Methodology
### Core Insight
Quantum GNNs can be constructed to satisfy the same structural guarantees as classical GNNs:
1. **Message passing** — the single primitive that generalizes convolution and attention
2. **Permutation equivariance** — output transforms correctly under node relabeling
3. **Weisfeiler-Leman (WL) hierarchy** — standard measure of graph discriminative power
### Three Design Principles
#### 1. Quantum Message Passing
- Encode graph structure into quantum states
- Implement message aggregation as quantum operations
- Each node's state is updated based on its neighborhood
- Quantum superposition enables parallel message processing
#### 2. Permutation Equivariance
- The quantum circuit must produce outputs that transform consistently under node permutations
- Achieved through symmetric quantum operations
- Ensures the model's predictions don't depend on arbitrary node ordering
#### 3. WL Hierarchy Placement
- Choose the WL level (1-WL, 2-WL, k-WL) for the desired discriminative power
- Higher WL levels can distinguish more complex graph structures
- Trade-off: higher levels require more quantum resources
### Pre-Training Strategy
- **Train on small graphs first** — mitigates trainability issues (barren plateaus)
- **Transfer learned representations** to larger graphs
- **Readout cost stays low** as graph grows (key scalability property)
- Validated on graphs up to 56 qubits
## Implementation Framework
### Step 1: Graph Encoding
```
Input: Graph G = (V, E) with node features
↓
Quantum encoding: |ψ_G⟩ = encode(V, E)
```
### Step 2: Message Passing Layers
```
For each layer l = 1...L:
For each node v:
|msg_v⟩ = aggregate(|ψ_u⟩ for u ∈ N(v)) # quantum aggregation
|ψ_v⟩^(l+1) = update(|ψ_v⟩^(l), |msg_v⟩) # quantum update
```
### Step 3: WL Hierarchy Control
- Choose k (WL level) based on problem complexity
- 1-WL: standard message passing
- 2-WL+: captures higher-order structure (cycles, motifs)
- k-WL: exponential expressivity in k
### Step 4: Readout
```
Output: readout(|ψ_G⟩) → classification/regression
```
- Readout cost is independent of graph size (critical for scalability)
## Validation Benchmarks
| Dataset | Type | Key Result |
|---------|------|------------|
| Synthetic non-separable graphs | Graph isomorphism | Separates graphs that classical MP cannot |
| Molecular property prediction | Chemistry | Competitive with classical GNNs |
| Traveling Salesperson Problem | Optimization | Validated up to 56 qubits |
## Key Parameters
| Parameter | Description | Notes |
|-----------|-------------|-------|
| `k` (WL level) | Discriminative power | Higher = more expressive, more qubits |
| `L` (layers) | Message passing depth | Similar to classical GNN depth |
| `pretrain_graph_size` | Size of pre-training graphs | Start small (10-20 nodes) |
| `readout_dim` | Readout dimension | Independent of graph size |
## Advantages
- **Theoretical guarantees**: provable expressivity via WL hierarchy
- **Scalability**: pre-train small, deploy large
- **Pre-training**: mitigates barren plateau problem
- **Permutation equivariance**: no arbitrary node ordering dependency
- **Open-source**: code available at github.com/SnehalRaj/mp-qgnns
## Pitfalls
- **Qubit requirements**: Higher WL levels need more qubits
- **Trainability**: Without pre-training, deep circuits may hit barren plateaus
- **Noise sensitivity**: Near-term hardware limitations
- **Classical baselines**: For simple graph problems, classical GNNs may suffice
## Related Papers
- arXiv:2606.26873 — Scalable Message-Passing Quantum GNNs in the WL Hierarchy
- Code: https://github.com/SnehalRaj/mp-qgnns
## Activation
quantum graph neural network, message passing quantum, weisfeiler-leman hierarchy, permutation equivariant quantum, quantum gnn pre-training, scalable quantum ml, graph isomorphism quantum, 56 qubit gnn, quantum combinatorial optimizationIs this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!