[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6JM6SD29CASGMYVY29MX2HW":3,"skill-same:01M6JM6SD29CASGMYVY29MX2HW":90},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":35,"linkOnly":36,"markdownContent":37,"markdownBody":38,"frontMatter":39,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":43,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M6JM6SD29CASGMYVY29MX2HW","torch-geometric",null,"Graph Neural Networks (PyG). Node\u002Fgraph classification, link prediction, GCN, GAT, GraphSAGE, heterogeneous graphs, molecular property prediction, for geometric deep learning.","transaurus\u002Fstaging-davila7-claude-code-templates","transaurus","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F210882017?v=4","01M6JH1R6ZCRXGJCTDP5ZKZBE6","Page Turner Agent","01M6JH1RBBR2P6Y0XWDGM4B0G7",0,"MIT","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34],"torch geometric","deep learning","neural networks","graph","networks","classification","learning","node","Neural","deep","graphs","molecular","gat","link","for","graph neural networks","2026-11-10 10:12:30",false,"---\nname: torch-geometric\ndescription: \"Graph Neural Networks (PyG). Node\u002Fgraph classification, link prediction, GCN, GAT, GraphSAGE, heterogeneous graphs, molecular property prediction, for geometric deep learning.\"\n---\n\n# PyTorch Geometric (PyG)\n\n## Overview\n\nPyTorch Geometric is a library built on PyTorch for developing and training Graph Neural Networks (GNNs). Apply this skill for deep learning on graphs and irregular structures, including mini-batch processing, multi-GPU training, and geometric deep learning applications.\n\n## When to Use This Skill\n\nThis skill should be used when working with:\n- **Graph-based machine learning**: Node classification, graph classification, link prediction\n- **Molecular property prediction**: Drug discovery, chemical property prediction\n- **Social network analysis**: Community detection, influence prediction\n- **Citation networks**: Paper classification, recommendation systems\n- **3D geometric data**: Point clouds, meshes, molecular structures\n- **Heterogeneous graphs**: Multi-type nodes and edges (e.g., knowledge graphs)\n- **Large-scale graph learning**: Neighbor sampling, distributed training\n\n## Quick Start\n\n### Installation\n\n```bash\nuv pip install torch_geometric\n```\n\nFor additional dependencies (sparse operations, clustering):\n```bash\nuv pip install pyg_lib torch_scatter torch_sparse torch_cluster torch_spline_conv -f https:\u002F\u002Fdata.pyg.org\u002Fwhl\u002Ftorch-${TORCH}+${CUDA}.html\n```\n\n### Basic Graph Creation\n\n```python\nimport torch\nfrom torch_geometric.data import Data\n\n# Create a simple graph with 3 nodes\nedge_index = torch.tensor([[0, 1, 1, 2],  # source nodes\n                           [1, 0, 2, 1]], dtype=torch.long)  # target nodes\nx = torch.tensor([[-1], [0], [1]], dtype=torch.float)  # node features\n\ndata = Data(x=x, edge_index=edge_index)\nprint(f\"Nodes: {data.num_nodes}, Edges: {data.num_edges}\")\n```\n\n### Loading a Benchmark Dataset\n\n```python\nfrom torch_geometric.datasets import Planetoid\n\n# Load Cora citation network\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')\ndata = dataset[0]  # Get the first (and only) graph\n\nprint(f\"Dataset: {dataset}\")\nprint(f\"Nodes: {data.num_nodes}, Edges: {data.num_edges}\")\nprint(f\"Features: {data.num_node_features}, Classes: {dataset.num_classes}\")\n```\n\n## Core Concepts\n\n### Data Structure\n\nPyG represents graphs using the `torch_geometric.data.Data` class with these key attributes:\n\n- **`data.x`**: Node feature matrix `[num_nodes, num_node_features]`\n- **`data.edge_index`**: Graph connectivity in COO format `[2, num_edges]`\n- **`data.edge_attr`**: Edge feature matrix `[num_edges, num_edge_features]` (optional)\n- **`data.y`**: Target labels for nodes or graphs\n- **`data.pos`**: Node spatial positions `[num_nodes, num_dimensions]` (optional)\n- **Custom attributes**: Can add any attribute (e.g., `data.train_mask`, `data.batch`)\n\n**Important**: These attributes are not mandatory—extend Data objects with custom attributes as needed.\n\n### Edge Index Format\n\nEdges are stored in COO (coordinate) format as a `[2, num_edges]` tensor:\n- First row: source node indices\n- Second row: target node indices\n\n```python\n# Edge list: (0→1), (1→0), (1→2), (2→1)\nedge_index = torch.tensor([[0, 1, 1, 2],\n                           [1, 0, 2, 1]], dtype=torch.long)\n```\n\n### Mini-Batch Processing\n\nPyG handles batching by creating block-diagonal adjacency matrices, concatenating multiple graphs into one large disconnected graph:\n\n- Adjacency matrices are stacked diagonally\n- Node features are concatenated along the node dimension\n- A `batch` vector maps each node to its source graph\n- No padding needed—computationally efficient\n\n```python\nfrom torch_geometric.loader import DataLoader\n\nloader = DataLoader(dataset, batch_size=32, shuffle=True)\nfor batch in loader:\n    print(f\"Batch size: {batch.num_graphs}\")\n    print(f\"Total nodes: {batch.num_nodes}\")\n    # batch.batch maps nodes to graphs\n```\n\n## Building Graph Neural Networks\n\n### Message Passing Paradigm\n\nGNNs in PyG follow a neighborhood aggregation scheme:\n1. Transform node features\n2. Propagate messages along edges\n3. Aggregate messages from neighbors\n4. Update node representations\n\n### Using Pre-Built Layers\n\nPyG provides 40+ convolutional layers. Common ones include:\n\n**GCNConv** (Graph Convolutional Network):\n```python\nfrom torch_geometric.nn import GCNConv\nimport torch.nn.functional as F\n\nclass GCN(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 16)\n        self.conv2 = GCNConv(16, num_classes)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = F.dropout(x, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n**GATConv** (Graph Attention Network):\n```python\nfrom torch_geometric.nn import GATConv\n\nclass GAT(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GATConv(num_features, 8, heads=8, dropout=0.6)\n        self.conv2 = GATConv(8 * 8, num_classes, heads=1, concat=False, dropout=0.6)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = F.dropout(x, p=0.6, training=self.training)\n        x = F.elu(self.conv1(x, edge_index))\n        x = F.dropout(x, p=0.6, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n**GraphSAGE**:\n```python\nfrom torch_geometric.nn import SAGEConv\n\nclass GraphSAGE(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = SAGEConv(num_features, 64)\n        self.conv2 = SAGEConv(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = F.dropout(x, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n### Custom Message Passing Layers\n\nFor custom layers, inherit from `MessagePassing`:\n\n```python\nfrom torch_geometric.nn import MessagePassing\nfrom torch_geometric.utils import add_self_loops, degree\n\nclass CustomConv(MessagePassing):\n    def __init__(self, in_channels, out_channels):\n        super().__init__(aggr='add')  # \"add\", \"mean\", or \"max\"\n        self.lin = torch.nn.Linear(in_channels, out_channels)\n\n    def forward(self, x, edge_index):\n        # Add self-loops to adjacency matrix\n        edge_index, _ = add_self_loops(edge_index, num_nodes=x.size(0))\n\n        # Transform node features\n        x = self.lin(x)\n\n        # Compute normalization\n        row, col = edge_index\n        deg = degree(col, x.size(0), dtype=x.dtype)\n        deg_inv_sqrt = deg.pow(-0.5)\n        norm = deg_inv_sqrt[row] * deg_inv_sqrt[col]\n\n        # Propagate messages\n        return self.propagate(edge_index, x=x, norm=norm)\n\n    def message(self, x_j, norm):\n        # x_j: features of source nodes\n        return norm.view(-1, 1) * x_j\n```\n\nKey methods:\n- **`forward()`**: Main entry point\n- **`message()`**: Constructs messages from source to target nodes\n- **`aggregate()`**: Aggregates messages (usually don't override—set `aggr` parameter)\n- **`update()`**: Updates node embeddings after aggregation\n\n**Variable naming convention**: Appending `_i` or `_j` to tensor names automatically maps them to target or source nodes.\n\n## Working with Datasets\n\n### Loading Built-in Datasets\n\nPyG provides extensive benchmark datasets:\n\n```python\n# Citation networks (node classification)\nfrom torch_geometric.datasets import Planetoid\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')  # or 'CiteSeer', 'PubMed'\n\n# Graph classification\nfrom torch_geometric.datasets import TUDataset\ndataset = TUDataset(root='\u002Ftmp\u002FENZYMES', name='ENZYMES')\n\n# Molecular datasets\nfrom torch_geometric.datasets import QM9\ndataset = QM9(root='\u002Ftmp\u002FQM9')\n\n# Large-scale datasets\nfrom torch_geometric.datasets import Reddit\ndataset = Reddit(root='\u002Ftmp\u002FReddit')\n```\n\nCheck `references\u002Fdatasets_reference.md` for a comprehensive list.\n\n### Creating Custom Datasets\n\nFor datasets that fit in memory, inherit from `InMemoryDataset`:\n\n```python\nfrom torch_geometric.data import InMemoryDataset, Data\nimport torch\n\nclass MyOwnDataset(InMemoryDataset):\n    def __init__(self, root, transform=None, pre_transform=None):\n        super().__init__(root, transform, pre_transform)\n        self.load(self.processed_paths[0])\n\n    @property\n    def raw_file_names(self):\n        return ['my_data.csv']  # Files needed in raw_dir\n\n    @property\n    def processed_file_names(self):\n        return ['data.pt']  # Files in processed_dir\n\n    def download(self):\n        # Download raw data to self.raw_dir\n        pass\n\n    def process(self):\n        # Read data, create Data objects\n        data_list = []\n\n        # Example: Create a simple graph\n        edge_index = torch.tensor([[0, 1], [1, 0]], dtype=torch.long)\n        x = torch.randn(2, 16)\n        y = torch.tensor([0], dtype=torch.long)\n\n        data = Data(x=x, edge_index=edge_index, y=y)\n        data_list.append(data)\n\n        # Apply pre_filter and pre_transform\n        if self.pre_filter is not None:\n            data_list = [d for d in data_list if self.pre_filter(d)]\n\n        if self.pre_transform is not None:\n            data_list = [self.pre_transform(d) for d in data_list]\n\n        # Save processed data\n        self.save(data_list, self.processed_paths[0])\n```\n\nFor large datasets that don't fit in memory, inherit from `Dataset` and implement `len()` and `get(idx)`.\n\n### Loading Graphs from CSV\n\n```python\nimport pandas as pd\nimport torch\nfrom torch_geometric.data import HeteroData\n\n# Load nodes\nnodes_df = pd.read_csv('nodes.csv')\nx = torch.tensor(nodes_df[['feat1', 'feat2']].values, dtype=torch.float)\n\n# Load edges\nedges_df = pd.read_csv('edges.csv')\nedge_index = torch.tensor([edges_df['source'].values,\n                           edges_df['target'].values], dtype=torch.long)\n\ndata = Data(x=x, edge_index=edge_index)\n```\n\n## Training Workflows\n\n### Node Classification (Single Graph)\n\n```python\nimport torch\nimport torch.nn.functional as F\nfrom torch_geometric.datasets import Planetoid\n\n# Load dataset\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')\ndata = dataset[0]\n\n# Create model\nmodel = GCN(dataset.num_features, dataset.num_classes)\noptimizer = torch.optim.Adam(model.parameters(), lr=0.01, weight_decay=5e-4)\n\n# Training\nmodel.train()\nfor epoch in range(200):\n    optimizer.zero_grad()\n    out = model(data)\n    loss = F.nll_loss(out[data.train_mask], data.y[data.train_mask])\n    loss.backward()\n    optimizer.step()\n\n    if epoch % 10 == 0:\n        print(f'Epoch {epoch}, Loss: {loss.item():.4f}')\n\n# Evaluation\nmodel.eval()\npred = model(data).argmax(dim=1)\ncorrect = (pred[data.test_mask] == data.y[data.test_mask]).sum()\nacc = int(correct) \u002F int(data.test_mask.sum())\nprint(f'Test Accuracy: {acc:.4f}')\n```\n\n### Graph Classification (Multiple Graphs)\n\n```python\nfrom torch_geometric.datasets import TUDataset\nfrom torch_geometric.loader import DataLoader\nfrom torch_geometric.nn import global_mean_pool\n\nclass GraphClassifier(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 64)\n        self.conv2 = GCNConv(64, 64)\n        self.lin = torch.nn.Linear(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index, batch = data.x, data.edge_index, data.batch\n\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = self.conv2(x, edge_index)\n        x = F.relu(x)\n\n        # Global pooling (aggregate node features to graph-level)\n        x = global_mean_pool(x, batch)\n\n        x = self.lin(x)\n        return F.log_softmax(x, dim=1)\n\n# Load dataset\ndataset = TUDataset(root='\u002Ftmp\u002FENZYMES', name='ENZYMES')\nloader = DataLoader(dataset, batch_size=32, shuffle=True)\n\nmodel = GraphClassifier(dataset.num_features, dataset.num_classes)\noptimizer = torch.optim.Adam(model.parameters(), lr=0.01)\n\n# Training\nmodel.train()\nfor epoch in range(100):\n    total_loss = 0\n    for batch in loader:\n        optimizer.zero_grad()\n        out = model(batch)\n        loss = F.nll_loss(out, batch.y)\n        loss.backward()\n        optimizer.step()\n        total_loss += loss.item()\n\n    if epoch % 10 == 0:\n        print(f'Epoch {epoch}, Loss: {total_loss \u002F len(loader):.4f}')\n```\n\n### Large-Scale Graphs with Neighbor Sampling\n\nFor large graphs, use `NeighborLoader` to sample subgraphs:\n\n```python\nfrom torch_geometric.loader import NeighborLoader\n\n# Create a neighbor sampler\ntrain_loader = NeighborLoader(\n    data,\n    num_neighbors=[25, 10],  # Sample 25 neighbors for 1st hop, 10 for 2nd hop\n    batch_size=128,\n    input_nodes=data.train_mask,\n)\n\n# Training\nmodel.train()\nfor batch in train_loader:\n    optimizer.zero_grad()\n    out = model(batch)\n    # Only compute loss on seed nodes (first batch_size nodes)\n    loss = F.nll_loss(out[:batch.batch_size], batch.y[:batch.batch_size])\n    loss.backward()\n    optimizer.step()\n```\n\n**Important**:\n- Output subgraphs are directed\n- Node indices are relabeled (0 to batch.num_nodes - 1)\n- Only use seed node predictions for loss computation\n- Sampling beyond 2-3 hops is generally not feasible\n\n## Advanced Features\n\n### Heterogeneous Graphs\n\nFor graphs with multiple node and edge types, use `HeteroData`:\n\n```python\nfrom torch_geometric.data import HeteroData\n\ndata = HeteroData()\n\n# Add node features for different types\ndata['paper'].x = torch.randn(100, 128)  # 100 papers with 128 features\ndata['author'].x = torch.randn(200, 64)  # 200 authors with 64 features\n\n# Add edges for different types (source_type, edge_type, target_type)\ndata['author', 'writes', 'paper'].edge_index = torch.randint(0, 200, (2, 500))\ndata['paper', 'cites', 'paper'].edge_index = torch.randint(0, 100, (2, 300))\n\nprint(data)\n```\n\nConvert homogeneous models to heterogeneous:\n\n```python\nfrom torch_geometric.nn import to_hetero\n\n# Define homogeneous model\nmodel = GNN(...)\n\n# Convert to heterogeneous\nmodel = to_hetero(model, data.metadata(), aggr='sum')\n\n# Use as normal\nout = model(data.x_dict, data.edge_index_dict)\n```\n\nOr use `HeteroConv` for custom edge-type-specific operations:\n\n```python\nfrom torch_geometric.nn import HeteroConv, GCNConv, SAGEConv\n\nclass HeteroGNN(torch.nn.Module):\n    def __init__(self, metadata):\n        super().__init__()\n        self.conv1 = HeteroConv({\n            ('paper', 'cites', 'paper'): GCNConv(-1, 64),\n            ('author', 'writes', 'paper'): SAGEConv((-1, -1), 64),\n        }, aggr='sum')\n\n        self.conv2 = HeteroConv({\n            ('paper', 'cites', 'paper'): GCNConv(64, 32),\n            ('author', 'writes', 'paper'): SAGEConv((64, 64), 32),\n        }, aggr='sum')\n\n    def forward(self, x_dict, edge_index_dict):\n        x_dict = self.conv1(x_dict, edge_index_dict)\n        x_dict = {key: F.relu(x) for key, x in x_dict.items()}\n        x_dict = self.conv2(x_dict, edge_index_dict)\n        return x_dict\n```\n\n### Transforms\n\nApply transforms to modify graph structure or features:\n\n```python\nfrom torch_geometric.transforms import NormalizeFeatures, AddSelfLoops, Compose\n\n# Single transform\ntransform = NormalizeFeatures()\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora', transform=transform)\n\n# Compose multiple transforms\ntransform = Compose([\n    AddSelfLoops(),\n    NormalizeFeatures(),\n])\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora', transform=transform)\n```\n\nCommon transforms:\n- **Structure**: `ToUndirected`, `AddSelfLoops`, `RemoveSelfLoops`, `KNNGraph`, `RadiusGraph`\n- **Features**: `NormalizeFeatures`, `NormalizeScale`, `Center`\n- **Sampling**: `RandomNodeSplit`, `RandomLinkSplit`\n- **Positional Encoding**: `AddLaplacianEigenvectorPE`, `AddRandomWalkPE`\n\nSee `references\u002Ftransforms_reference.md` for the full list.\n\n### Model Explainability\n\nPyG provides explainability tools to understand model predictions:\n\n```python\nfrom torch_geometric.explain import Explainer, GNNExplainer\n\n# Create explainer\nexplainer = Explainer(\n    model=model,\n    algorithm=GNNExplainer(epochs=200),\n    explanation_type='model',  # or 'phenomenon'\n    node_mask_type='attributes',\n    edge_mask_type='object',\n    model_config=dict(\n        mode='multiclass_classification',\n        task_level='node',\n        return_type='log_probs',\n    ),\n)\n\n# Generate explanation for a specific node\nnode_idx = 10\nexplanation = explainer(data.x, data.edge_index, index=node_idx)\n\n# Visualize\nprint(f'Node {node_idx} explanation:')\nprint(f'Important edges: {explanation.edge_mask.topk(5).indices}')\nprint(f'Important features: {explanation.node_mask[node_idx].topk(5).indices}')\n```\n\n### Pooling Operations\n\nFor hierarchical graph representations:\n\n```python\nfrom torch_geometric.nn import TopKPooling, global_mean_pool\n\nclass HierarchicalGNN(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 64)\n        self.pool1 = TopKPooling(64, ratio=0.8)\n        self.conv2 = GCNConv(64, 64)\n        self.pool2 = TopKPooling(64, ratio=0.8)\n        self.lin = torch.nn.Linear(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index, batch = data.x, data.edge_index, data.batch\n\n        x = F.relu(self.conv1(x, edge_index))\n        x, edge_index, _, batch, _, _ = self.pool1(x, edge_index, None, batch)\n\n        x = F.relu(self.conv2(x, edge_index))\n        x, edge_index, _, batch, _, _ = self.pool2(x, edge_index, None, batch)\n\n        x = global_mean_pool(x, batch)\n        x = self.lin(x)\n        return F.log_softmax(x, dim=1)\n```\n\n## Common Patterns and Best Practices\n\n### Check Graph Properties\n\n```python\n# Undirected check\nfrom torch_geometric.utils import is_undirected\nprint(f\"Is undirected: {is_undirected(data.edge_index)}\")\n\n# Connected components\nfrom torch_geometric.utils import connected_components\nprint(f\"Connected components: {connected_components(data.edge_index)}\")\n\n# Contains self-loops\nfrom torch_geometric.utils import contains_self_loops\nprint(f\"Has self-loops: {contains_self_loops(data.edge_index)}\")\n```\n\n### GPU Training\n\n```python\ndevice = torch.device('cuda' if torch.cuda.is_available() else 'cpu')\nmodel = model.to(device)\ndata = data.to(device)\n\n# For DataLoader\nfor batch in loader:\n    batch = batch.to(device)\n    # Train...\n```\n\n### Save and Load Models\n\n```python\n# Save\ntorch.save(model.state_dict(), 'model.pth')\n\n# Load\nmodel = GCN(num_features, num_classes)\nmodel.load_state_dict(torch.load('model.pth'))\nmodel.eval()\n```\n\n### Layer Capabilities\n\nWhen choosing layers, consider these capabilities:\n- **SparseTensor**: Supports efficient sparse matrix operations\n- **edge_weight**: Handles one-dimensional edge weights\n- **edge_attr**: Processes multi-dimensional edge features\n- **Bipartite**: Works with bipartite graphs (different source\u002Ftarget dimensions)\n- **Lazy**: Enables initialization without specifying input dimensions\n\nSee the GNN cheatsheet at `references\u002Flayer_capabilities.md`.\n\n## Resources\n\n### Bundled References\n\nThis skill includes detailed reference documentation:\n\n- **`references\u002Flayers_reference.md`**: Complete listing of all 40+ GNN layers with descriptions and capabilities\n- **`references\u002Fdatasets_reference.md`**: Comprehensive dataset catalog organized by category\n- **`references\u002Ftransforms_reference.md`**: All available transforms and their use cases\n- **`references\u002Fapi_patterns.md`**: Common API patterns and coding examples\n\n### Scripts\n\nUtility scripts are provided in `scripts\u002F`:\n\n- **`scripts\u002Fvisualize_graph.py`**: Visualize graph structure using networkx and matplotlib\n- **`scripts\u002Fcreate_gnn_template.py`**: Generate boilerplate code for common GNN architectures\n- **`scripts\u002Fbenchmark_model.py`**: Benchmark model performance on standard datasets\n\nExecute scripts directly or read them for implementation patterns.\n\n### Official Resources\n\n- **Documentation**: https:\u002F\u002Fpytorch-geometric.readthedocs.io\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fpyg-team\u002Fpytorch_geometric\n- **Tutorials**: https:\u002F\u002Fpytorch-geometric.readthedocs.io\u002Fen\u002Flatest\u002Fget_started\u002Fintroduction.html\n- **Examples**: https:\u002F\u002Fgithub.com\u002Fpyg-team\u002Fpytorch_geometric\u002Ftree\u002Fmaster\u002Fexamples\n","# PyTorch Geometric (PyG)\n\n## Overview\n\nPyTorch Geometric is a library built on PyTorch for developing and training Graph Neural Networks (GNNs). Apply this skill for deep learning on graphs and irregular structures, including mini-batch processing, multi-GPU training, and geometric deep learning applications.\n\n## When to Use This Skill\n\nThis skill should be used when working with:\n- **Graph-based machine learning**: Node classification, graph classification, link prediction\n- **Molecular property prediction**: Drug discovery, chemical property prediction\n- **Social network analysis**: Community detection, influence prediction\n- **Citation networks**: Paper classification, recommendation systems\n- **3D geometric data**: Point clouds, meshes, molecular structures\n- **Heterogeneous graphs**: Multi-type nodes and edges (e.g., knowledge graphs)\n- **Large-scale graph learning**: Neighbor sampling, distributed training\n\n## Quick Start\n\n### Installation\n\n```bash\nuv pip install torch_geometric\n```\n\nFor additional dependencies (sparse operations, clustering):\n```bash\nuv pip install pyg_lib torch_scatter torch_sparse torch_cluster torch_spline_conv -f https:\u002F\u002Fdata.pyg.org\u002Fwhl\u002Ftorch-${TORCH}+${CUDA}.html\n```\n\n### Basic Graph Creation\n\n```python\nimport torch\nfrom torch_geometric.data import Data\n\n# Create a simple graph with 3 nodes\nedge_index = torch.tensor([[0, 1, 1, 2],  # source nodes\n                           [1, 0, 2, 1]], dtype=torch.long)  # target nodes\nx = torch.tensor([[-1], [0], [1]], dtype=torch.float)  # node features\n\ndata = Data(x=x, edge_index=edge_index)\nprint(f\"Nodes: {data.num_nodes}, Edges: {data.num_edges}\")\n```\n\n### Loading a Benchmark Dataset\n\n```python\nfrom torch_geometric.datasets import Planetoid\n\n# Load Cora citation network\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')\ndata = dataset[0]  # Get the first (and only) graph\n\nprint(f\"Dataset: {dataset}\")\nprint(f\"Nodes: {data.num_nodes}, Edges: {data.num_edges}\")\nprint(f\"Features: {data.num_node_features}, Classes: {dataset.num_classes}\")\n```\n\n## Core Concepts\n\n### Data Structure\n\nPyG represents graphs using the `torch_geometric.data.Data` class with these key attributes:\n\n- **`data.x`**: Node feature matrix `[num_nodes, num_node_features]`\n- **`data.edge_index`**: Graph connectivity in COO format `[2, num_edges]`\n- **`data.edge_attr`**: Edge feature matrix `[num_edges, num_edge_features]` (optional)\n- **`data.y`**: Target labels for nodes or graphs\n- **`data.pos`**: Node spatial positions `[num_nodes, num_dimensions]` (optional)\n- **Custom attributes**: Can add any attribute (e.g., `data.train_mask`, `data.batch`)\n\n**Important**: These attributes are not mandatory—extend Data objects with custom attributes as needed.\n\n### Edge Index Format\n\nEdges are stored in COO (coordinate) format as a `[2, num_edges]` tensor:\n- First row: source node indices\n- Second row: target node indices\n\n```python\n# Edge list: (0→1), (1→0), (1→2), (2→1)\nedge_index = torch.tensor([[0, 1, 1, 2],\n                           [1, 0, 2, 1]], dtype=torch.long)\n```\n\n### Mini-Batch Processing\n\nPyG handles batching by creating block-diagonal adjacency matrices, concatenating multiple graphs into one large disconnected graph:\n\n- Adjacency matrices are stacked diagonally\n- Node features are concatenated along the node dimension\n- A `batch` vector maps each node to its source graph\n- No padding needed—computationally efficient\n\n```python\nfrom torch_geometric.loader import DataLoader\n\nloader = DataLoader(dataset, batch_size=32, shuffle=True)\nfor batch in loader:\n    print(f\"Batch size: {batch.num_graphs}\")\n    print(f\"Total nodes: {batch.num_nodes}\")\n    # batch.batch maps nodes to graphs\n```\n\n## Building Graph Neural Networks\n\n### Message Passing Paradigm\n\nGNNs in PyG follow a neighborhood aggregation scheme:\n1. Transform node features\n2. Propagate messages along edges\n3. Aggregate messages from neighbors\n4. Update node representations\n\n### Using Pre-Built Layers\n\nPyG provides 40+ convolutional layers. Common ones include:\n\n**GCNConv** (Graph Convolutional Network):\n```python\nfrom torch_geometric.nn import GCNConv\nimport torch.nn.functional as F\n\nclass GCN(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 16)\n        self.conv2 = GCNConv(16, num_classes)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = F.dropout(x, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n**GATConv** (Graph Attention Network):\n```python\nfrom torch_geometric.nn import GATConv\n\nclass GAT(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GATConv(num_features, 8, heads=8, dropout=0.6)\n        self.conv2 = GATConv(8 * 8, num_classes, heads=1, concat=False, dropout=0.6)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = F.dropout(x, p=0.6, training=self.training)\n        x = F.elu(self.conv1(x, edge_index))\n        x = F.dropout(x, p=0.6, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n**GraphSAGE**:\n```python\nfrom torch_geometric.nn import SAGEConv\n\nclass GraphSAGE(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = SAGEConv(num_features, 64)\n        self.conv2 = SAGEConv(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index = data.x, data.edge_index\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = F.dropout(x, training=self.training)\n        x = self.conv2(x, edge_index)\n        return F.log_softmax(x, dim=1)\n```\n\n### Custom Message Passing Layers\n\nFor custom layers, inherit from `MessagePassing`:\n\n```python\nfrom torch_geometric.nn import MessagePassing\nfrom torch_geometric.utils import add_self_loops, degree\n\nclass CustomConv(MessagePassing):\n    def __init__(self, in_channels, out_channels):\n        super().__init__(aggr='add')  # \"add\", \"mean\", or \"max\"\n        self.lin = torch.nn.Linear(in_channels, out_channels)\n\n    def forward(self, x, edge_index):\n        # Add self-loops to adjacency matrix\n        edge_index, _ = add_self_loops(edge_index, num_nodes=x.size(0))\n\n        # Transform node features\n        x = self.lin(x)\n\n        # Compute normalization\n        row, col = edge_index\n        deg = degree(col, x.size(0), dtype=x.dtype)\n        deg_inv_sqrt = deg.pow(-0.5)\n        norm = deg_inv_sqrt[row] * deg_inv_sqrt[col]\n\n        # Propagate messages\n        return self.propagate(edge_index, x=x, norm=norm)\n\n    def message(self, x_j, norm):\n        # x_j: features of source nodes\n        return norm.view(-1, 1) * x_j\n```\n\nKey methods:\n- **`forward()`**: Main entry point\n- **`message()`**: Constructs messages from source to target nodes\n- **`aggregate()`**: Aggregates messages (usually don't override—set `aggr` parameter)\n- **`update()`**: Updates node embeddings after aggregation\n\n**Variable naming convention**: Appending `_i` or `_j` to tensor names automatically maps them to target or source nodes.\n\n## Working with Datasets\n\n### Loading Built-in Datasets\n\nPyG provides extensive benchmark datasets:\n\n```python\n# Citation networks (node classification)\nfrom torch_geometric.datasets import Planetoid\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')  # or 'CiteSeer', 'PubMed'\n\n# Graph classification\nfrom torch_geometric.datasets import TUDataset\ndataset = TUDataset(root='\u002Ftmp\u002FENZYMES', name='ENZYMES')\n\n# Molecular datasets\nfrom torch_geometric.datasets import QM9\ndataset = QM9(root='\u002Ftmp\u002FQM9')\n\n# Large-scale datasets\nfrom torch_geometric.datasets import Reddit\ndataset = Reddit(root='\u002Ftmp\u002FReddit')\n```\n\nCheck `references\u002Fdatasets_reference.md` for a comprehensive list.\n\n### Creating Custom Datasets\n\nFor datasets that fit in memory, inherit from `InMemoryDataset`:\n\n```python\nfrom torch_geometric.data import InMemoryDataset, Data\nimport torch\n\nclass MyOwnDataset(InMemoryDataset):\n    def __init__(self, root, transform=None, pre_transform=None):\n        super().__init__(root, transform, pre_transform)\n        self.load(self.processed_paths[0])\n\n    @property\n    def raw_file_names(self):\n        return ['my_data.csv']  # Files needed in raw_dir\n\n    @property\n    def processed_file_names(self):\n        return ['data.pt']  # Files in processed_dir\n\n    def download(self):\n        # Download raw data to self.raw_dir\n        pass\n\n    def process(self):\n        # Read data, create Data objects\n        data_list = []\n\n        # Example: Create a simple graph\n        edge_index = torch.tensor([[0, 1], [1, 0]], dtype=torch.long)\n        x = torch.randn(2, 16)\n        y = torch.tensor([0], dtype=torch.long)\n\n        data = Data(x=x, edge_index=edge_index, y=y)\n        data_list.append(data)\n\n        # Apply pre_filter and pre_transform\n        if self.pre_filter is not None:\n            data_list = [d for d in data_list if self.pre_filter(d)]\n\n        if self.pre_transform is not None:\n            data_list = [self.pre_transform(d) for d in data_list]\n\n        # Save processed data\n        self.save(data_list, self.processed_paths[0])\n```\n\nFor large datasets that don't fit in memory, inherit from `Dataset` and implement `len()` and `get(idx)`.\n\n### Loading Graphs from CSV\n\n```python\nimport pandas as pd\nimport torch\nfrom torch_geometric.data import HeteroData\n\n# Load nodes\nnodes_df = pd.read_csv('nodes.csv')\nx = torch.tensor(nodes_df[['feat1', 'feat2']].values, dtype=torch.float)\n\n# Load edges\nedges_df = pd.read_csv('edges.csv')\nedge_index = torch.tensor([edges_df['source'].values,\n                           edges_df['target'].values], dtype=torch.long)\n\ndata = Data(x=x, edge_index=edge_index)\n```\n\n## Training Workflows\n\n### Node Classification (Single Graph)\n\n```python\nimport torch\nimport torch.nn.functional as F\nfrom torch_geometric.datasets import Planetoid\n\n# Load dataset\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora')\ndata = dataset[0]\n\n# Create model\nmodel = GCN(dataset.num_features, dataset.num_classes)\noptimizer = torch.optim.Adam(model.parameters(), lr=0.01, weight_decay=5e-4)\n\n# Training\nmodel.train()\nfor epoch in range(200):\n    optimizer.zero_grad()\n    out = model(data)\n    loss = F.nll_loss(out[data.train_mask], data.y[data.train_mask])\n    loss.backward()\n    optimizer.step()\n\n    if epoch % 10 == 0:\n        print(f'Epoch {epoch}, Loss: {loss.item():.4f}')\n\n# Evaluation\nmodel.eval()\npred = model(data).argmax(dim=1)\ncorrect = (pred[data.test_mask] == data.y[data.test_mask]).sum()\nacc = int(correct) \u002F int(data.test_mask.sum())\nprint(f'Test Accuracy: {acc:.4f}')\n```\n\n### Graph Classification (Multiple Graphs)\n\n```python\nfrom torch_geometric.datasets import TUDataset\nfrom torch_geometric.loader import DataLoader\nfrom torch_geometric.nn import global_mean_pool\n\nclass GraphClassifier(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 64)\n        self.conv2 = GCNConv(64, 64)\n        self.lin = torch.nn.Linear(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index, batch = data.x, data.edge_index, data.batch\n\n        x = self.conv1(x, edge_index)\n        x = F.relu(x)\n        x = self.conv2(x, edge_index)\n        x = F.relu(x)\n\n        # Global pooling (aggregate node features to graph-level)\n        x = global_mean_pool(x, batch)\n\n        x = self.lin(x)\n        return F.log_softmax(x, dim=1)\n\n# Load dataset\ndataset = TUDataset(root='\u002Ftmp\u002FENZYMES', name='ENZYMES')\nloader = DataLoader(dataset, batch_size=32, shuffle=True)\n\nmodel = GraphClassifier(dataset.num_features, dataset.num_classes)\noptimizer = torch.optim.Adam(model.parameters(), lr=0.01)\n\n# Training\nmodel.train()\nfor epoch in range(100):\n    total_loss = 0\n    for batch in loader:\n        optimizer.zero_grad()\n        out = model(batch)\n        loss = F.nll_loss(out, batch.y)\n        loss.backward()\n        optimizer.step()\n        total_loss += loss.item()\n\n    if epoch % 10 == 0:\n        print(f'Epoch {epoch}, Loss: {total_loss \u002F len(loader):.4f}')\n```\n\n### Large-Scale Graphs with Neighbor Sampling\n\nFor large graphs, use `NeighborLoader` to sample subgraphs:\n\n```python\nfrom torch_geometric.loader import NeighborLoader\n\n# Create a neighbor sampler\ntrain_loader = NeighborLoader(\n    data,\n    num_neighbors=[25, 10],  # Sample 25 neighbors for 1st hop, 10 for 2nd hop\n    batch_size=128,\n    input_nodes=data.train_mask,\n)\n\n# Training\nmodel.train()\nfor batch in train_loader:\n    optimizer.zero_grad()\n    out = model(batch)\n    # Only compute loss on seed nodes (first batch_size nodes)\n    loss = F.nll_loss(out[:batch.batch_size], batch.y[:batch.batch_size])\n    loss.backward()\n    optimizer.step()\n```\n\n**Important**:\n- Output subgraphs are directed\n- Node indices are relabeled (0 to batch.num_nodes - 1)\n- Only use seed node predictions for loss computation\n- Sampling beyond 2-3 hops is generally not feasible\n\n## Advanced Features\n\n### Heterogeneous Graphs\n\nFor graphs with multiple node and edge types, use `HeteroData`:\n\n```python\nfrom torch_geometric.data import HeteroData\n\ndata = HeteroData()\n\n# Add node features for different types\ndata['paper'].x = torch.randn(100, 128)  # 100 papers with 128 features\ndata['author'].x = torch.randn(200, 64)  # 200 authors with 64 features\n\n# Add edges for different types (source_type, edge_type, target_type)\ndata['author', 'writes', 'paper'].edge_index = torch.randint(0, 200, (2, 500))\ndata['paper', 'cites', 'paper'].edge_index = torch.randint(0, 100, (2, 300))\n\nprint(data)\n```\n\nConvert homogeneous models to heterogeneous:\n\n```python\nfrom torch_geometric.nn import to_hetero\n\n# Define homogeneous model\nmodel = GNN(...)\n\n# Convert to heterogeneous\nmodel = to_hetero(model, data.metadata(), aggr='sum')\n\n# Use as normal\nout = model(data.x_dict, data.edge_index_dict)\n```\n\nOr use `HeteroConv` for custom edge-type-specific operations:\n\n```python\nfrom torch_geometric.nn import HeteroConv, GCNConv, SAGEConv\n\nclass HeteroGNN(torch.nn.Module):\n    def __init__(self, metadata):\n        super().__init__()\n        self.conv1 = HeteroConv({\n            ('paper', 'cites', 'paper'): GCNConv(-1, 64),\n            ('author', 'writes', 'paper'): SAGEConv((-1, -1), 64),\n        }, aggr='sum')\n\n        self.conv2 = HeteroConv({\n            ('paper', 'cites', 'paper'): GCNConv(64, 32),\n            ('author', 'writes', 'paper'): SAGEConv((64, 64), 32),\n        }, aggr='sum')\n\n    def forward(self, x_dict, edge_index_dict):\n        x_dict = self.conv1(x_dict, edge_index_dict)\n        x_dict = {key: F.relu(x) for key, x in x_dict.items()}\n        x_dict = self.conv2(x_dict, edge_index_dict)\n        return x_dict\n```\n\n### Transforms\n\nApply transforms to modify graph structure or features:\n\n```python\nfrom torch_geometric.transforms import NormalizeFeatures, AddSelfLoops, Compose\n\n# Single transform\ntransform = NormalizeFeatures()\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora', transform=transform)\n\n# Compose multiple transforms\ntransform = Compose([\n    AddSelfLoops(),\n    NormalizeFeatures(),\n])\ndataset = Planetoid(root='\u002Ftmp\u002FCora', name='Cora', transform=transform)\n```\n\nCommon transforms:\n- **Structure**: `ToUndirected`, `AddSelfLoops`, `RemoveSelfLoops`, `KNNGraph`, `RadiusGraph`\n- **Features**: `NormalizeFeatures`, `NormalizeScale`, `Center`\n- **Sampling**: `RandomNodeSplit`, `RandomLinkSplit`\n- **Positional Encoding**: `AddLaplacianEigenvectorPE`, `AddRandomWalkPE`\n\nSee `references\u002Ftransforms_reference.md` for the full list.\n\n### Model Explainability\n\nPyG provides explainability tools to understand model predictions:\n\n```python\nfrom torch_geometric.explain import Explainer, GNNExplainer\n\n# Create explainer\nexplainer = Explainer(\n    model=model,\n    algorithm=GNNExplainer(epochs=200),\n    explanation_type='model',  # or 'phenomenon'\n    node_mask_type='attributes',\n    edge_mask_type='object',\n    model_config=dict(\n        mode='multiclass_classification',\n        task_level='node',\n        return_type='log_probs',\n    ),\n)\n\n# Generate explanation for a specific node\nnode_idx = 10\nexplanation = explainer(data.x, data.edge_index, index=node_idx)\n\n# Visualize\nprint(f'Node {node_idx} explanation:')\nprint(f'Important edges: {explanation.edge_mask.topk(5).indices}')\nprint(f'Important features: {explanation.node_mask[node_idx].topk(5).indices}')\n```\n\n### Pooling Operations\n\nFor hierarchical graph representations:\n\n```python\nfrom torch_geometric.nn import TopKPooling, global_mean_pool\n\nclass HierarchicalGNN(torch.nn.Module):\n    def __init__(self, num_features, num_classes):\n        super().__init__()\n        self.conv1 = GCNConv(num_features, 64)\n        self.pool1 = TopKPooling(64, ratio=0.8)\n        self.conv2 = GCNConv(64, 64)\n        self.pool2 = TopKPooling(64, ratio=0.8)\n        self.lin = torch.nn.Linear(64, num_classes)\n\n    def forward(self, data):\n        x, edge_index, batch = data.x, data.edge_index, data.batch\n\n        x = F.relu(self.conv1(x, edge_index))\n        x, edge_index, _, batch, _, _ = self.pool1(x, edge_index, None, batch)\n\n        x = F.relu(self.conv2(x, edge_index))\n        x, edge_index, _, batch, _, _ = self.pool2(x, edge_index, None, batch)\n\n        x = global_mean_pool(x, batch)\n        x = self.lin(x)\n        return F.log_softmax(x, dim=1)\n```\n\n## Common Patterns and Best Practices\n\n### Check Graph Properties\n\n```python\n# Undirected check\nfrom torch_geometric.utils import is_undirected\nprint(f\"Is undirected: {is_undirected(data.edge_index)}\")\n\n# Connected components\nfrom torch_geometric.utils import connected_components\nprint(f\"Connected components: {connected_components(data.edge_index)}\")\n\n# Contains self-loops\nfrom torch_geometric.utils import contains_self_loops\nprint(f\"Has self-loops: {contains_self_loops(data.edge_index)}\")\n```\n\n### GPU Training\n\n```python\ndevice = torch.device('cuda' if torch.cuda.is_available() else 'cpu')\nmodel = model.to(device)\ndata = data.to(device)\n\n# For DataLoader\nfor batch in loader:\n    batch = batch.to(device)\n    # Train...\n```\n\n### Save and Load Models\n\n```python\n# Save\ntorch.save(model.state_dict(), 'model.pth')\n\n# Load\nmodel = GCN(num_features, num_classes)\nmodel.load_state_dict(torch.load('model.pth'))\nmodel.eval()\n```\n\n### Layer Capabilities\n\nWhen choosing layers, consider these capabilities:\n- **SparseTensor**: Supports efficient sparse matrix operations\n- **edge_weight**: Handles one-dimensional edge weights\n- **edge_attr**: Processes multi-dimensional edge features\n- **Bipartite**: Works with bipartite graphs (different source\u002Ftarget dimensions)\n- **Lazy**: Enables initialization without specifying input dimensions\n\nSee the GNN cheatsheet at `references\u002Flayer_capabilities.md`.\n\n## Resources\n\n### Bundled References\n\nThis skill includes detailed reference documentation:\n\n- **`references\u002Flayers_reference.md`**: Complete listing of all 40+ GNN layers with descriptions and capabilities\n- **`references\u002Fdatasets_reference.md`**: Comprehensive dataset catalog organized by category\n- **`references\u002Ftransforms_reference.md`**: All available transforms and their use cases\n- **`references\u002Fapi_patterns.md`**: Common API patterns and coding examples\n\n### Scripts\n\nUtility scripts are provided in `scripts\u002F`:\n\n- **`scripts\u002Fvisualize_graph.py`**: Visualize graph structure using networkx and matplotlib\n- **`scripts\u002Fcreate_gnn_template.py`**: Generate boilerplate code for common GNN architectures\n- **`scripts\u002Fbenchmark_model.py`**: Benchmark model performance on standard datasets\n\nExecute scripts directly or read them for implementation patterns.\n\n### Official Resources\n\n- **Documentation**: https:\u002F\u002Fpytorch-geometric.readthedocs.io\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fpyg-team\u002Fpytorch_geometric\n- **Tutorials**: https:\u002F\u002Fpytorch-geometric.readthedocs.io\u002Fen\u002Flatest\u002Fget_started\u002Fintroduction.html\n- **Examples**: https:\u002F\u002Fgithub.com\u002Fpyg-team\u002Fpytorch_geometric\u002Ftree\u002Fmaster\u002Fexamples\n",{"name":5,"description":7},"main","34fa6acf794b9a6310d298cbb8fb8c9420a5edcf","cli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric",2,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates","https:\u002F\u002Fgithub.com\u002Ftransaurus","Automated works of Page Turner","2026-03-28 10:12:59",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add transaurus\u002Fstaging-davila7-claude-code-templates --skill torch-geometric",{"tool":54,"command":55},"bunx","bunx skills add transaurus\u002Fstaging-davila7-claude-code-templates --skill torch-geometric",{"tool":57,"command":58},"pnpm","pnpm dlx skills add transaurus\u002Fstaging-davila7-claude-code-templates --skill torch-geometric","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002FSKILL.md",true,[62,68,72,76,82,86],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fdatasets_reference.md","REFERENCE","参考文档",15940,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Freferences\u002Fdatasets_reference.md",{"path":69,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Flayers_reference.md",17121,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Freferences\u002Flayers_reference.md",{"path":73,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Ftransforms_reference.md",17950,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Freferences\u002Ftransforms_reference.md",{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Fbenchmark_model.py","SCRIPT","脚本",10028,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Fscripts\u002Fbenchmark_model.py",{"path":83,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":84,"sourceHtmlUrl":85},"scripts\u002Fcreate_gnn_template.py",15342,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Fscripts\u002Fcreate_gnn_template.py",{"path":87,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Fvisualize_graph.py",10267,"https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Ftorch_geometric\u002Fscripts\u002Fvisualize_graph.py",[91,122,143,167,187,213],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":102,"publishedAt":35},"01M6JMRJR3BE0HGWFWDZSB853S","zapier-make-patterns","No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points.  This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fzapier-make-patterns\u002FSKILL.md",[97],{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,33,121],"zapier make patterns","patterns","make","zapier","writing","workflow","automation","code","integrations","business","use","power","complexity","platform","apps","how to","No-Code","which","spawner",{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":35},"01M6JMR8YK6SWPCTG1MCQTMN9S","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fyeet\u002FSKILL.md",[],[124,129,130,131,132,133,134,135,136,137,138,139,113,140,141,142],"cli","github","commit","pull request","openai","pull","push","flow","open","gh","user","only","stage","github cli",{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":150,"publishedAt":35},"01M6JMQNFE64ZASQK90HARRXW8","workflow-automation","Workflow automation is the infrastructure that makes AI agents reliable. Without durable execution, a network hiccup during a 10-step payment flow means lost money and angry customers. With it, workflows resume exactly where they left off.  This skill covers the platforms (n8n, Temporal, Inngest) and patterns (sequential, parallel, orchestrator-worker) that turn brittle scripts into production-grade automation.  Key insight: The platforms make different tradeoffs. n8n optimizes for accessibility","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fworkflow-automation\u002FSKILL.md",[149],{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},[108,109,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,33,121],"Workflow Automation","ai agents","accessibility","workflows","apache","execution","inngest","parallel","orchestrator","resume","n8n","payment","worker","scripts","temporal","with",{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":171,"categories":172,"keywords":173,"publishedAt":35},"01M6JMQDYJ0XETERPHGDR3EVGN","trigger-dev","Trigger.dev expert for background jobs, AI workflows, and reliable async execution with excellent developer experience and TypeScript-first design. Use when: trigger.dev, trigger dev, background task, ai background job, long running task.","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Ftrigger-dev\u002FSKILL.md",[],[174,175,176,177,178,154,179,155,156,180,113,181,182,183,184,185,186,166,33,121],"dev","trigger dev","trigger","design","typescript","async execution","first","async","developer experience","expert","task","background jobs","long",{"skillNo":188,"name":189,"nameZh":6,"description":190,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":191,"categories":192,"keywords":196,"publishedAt":35},"01M6JMQ5J6KK3GSX9FJCWWK6G6","planning-with-files","Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Use when starting complex tasks, multi-step projects, research tasks, or when the user mentions planning, organizing work, tracking progress, or wants structured output.","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fplanning-with-files\u002FSKILL.md",[193],{"categoryNo":194,"categoryName":195,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000021","资料检索与研究",[197,198,199,166,200,108,201,202,203,204,205,206,113,207,208,209,210,211,212,33],"planning with files","planning","files","with files","storage","tasks","markdown","knowledge","projects","work","manus","structured output","progress","transforms","multi","output",{"skillNo":214,"name":215,"nameZh":6,"description":216,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":217,"categories":218,"keywords":223,"publishedAt":35},"01M6JMPWAT60RXXNEC4V9TRBRS","n8n-workflow-patterns","Proven workflow architectural patterns from real n8n workflows. Use when building new workflows, designing workflow structure, choosing workflow patterns, planning workflow architecture, or asking about webhook processing, HTTP API integration, database operations, AI agent workflows, or scheduled tasks.","https:\u002F\u002Fgithub.com\u002Ftransaurus\u002Fstaging-davila7-claude-code-templates\u002Fblob\u002Fmain\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fn8n\u002Fn8n-workflow-patterns\u002FSKILL.md",[219,222],{"categoryNo":220,"categoryName":221,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},[108,224,161,225,104,226,227,154,228,202,198,229,230,231,232,233,234,235,236,237],"n8n workflow patterns","workflow patterns","n8n workflow","ai agent","architecture","database","api","planning workflow","structure","database operations","webhook","processing","http api","scheduled"]