# Migrate a Subgraph to Goldsky

Moving from The Graph can require a reliable source identifier, deployment path, and endpoint transition. This skill guides the migration and verifies sync before application cutover.

## Install

```bash
npx skillstore add goldsky-io/subgraph-migrate
```

## Metadata

- Status: approved
- Slug: goldsky-io-subgraph-migrate
- Skillstore revision: r1
- Version status: missing
- Tree hash: 2cf4c59deed595c54f7cce0243fa56efdb55b5a797846ada1c28c200413fde4c
- Author: goldsky-io
- GitHub username: goldsky-io
- License: MIT
- Repository: https://github.com/goldsky-io/goldsky-agent/tree/e8e18c16233d9a7cee64dc548ba779c5fb99205a/skills/subgraph-migrate
- Ref: 8b5ad1599e7c55e9b6c627bca3f556f6e9061cb1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: blocked
- Manual install advisory: allowed\_with\_warning
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/goldsky-io-subgraph-migrate
- Manifest: https://skillstore.pages.dev/api/skills/goldsky-io-subgraph-migrate/manifest

## Capabilities

- Selects migration paths using a public endpoint, IPFS deployment hash, or local source.
- Requests the real source identifier instead of guessing a URL or hash.
- Guides Goldsky CLI installation, login, deployment, and status checks.
- Explains how to verify indexing progress with the metadata query.
- Guides stable tag creation and application endpoint replacement.
- Routes deployment and synchronization errors to the appropriate troubleshooting skill.

## Use Cases

- Replace a The Graph endpoint: Move a production subgraph to Goldsky while preserving the existing application query model.
- Recover a sunset deployment: Use an existing endpoint or IPFS deployment hash when a former hosted subgraph endpoint is unavailable.
- Validate a migration rollout: Deploy, monitor indexing, create a stable tag, and prepare the new endpoint for an application cutover.

## Prompt Templates

### Start a migration

```
Help me migrate my subgraph from The Graph to Goldsky. Ask for the current endpoint or IPFS deployment hash before choosing a path.
```

### Choose the source

```
I have a public GraphQL endpoint, an IPFS deployment hash, and local source. Compare the migration paths and recommend the safest option.
```

### Deploy and verify

```
Guide me through deploying this subgraph to Goldsky, checking indexing progress, and identifying whether any error requires troubleshooting.
```

### Plan production cutover

```
Create a production cutover checklist for my Goldsky subgraph, including a stable tag, endpoint validation, rollback considerations, and sync verification.
```

## Limitations

- It does not migrate subgraphs from Alchemy or other providers.
- It does not diagnose complex deployment or synchronization failures.
- It cannot verify credentials, account access, or project permissions.
- It does not estimate migration pricing or guarantee indexing duration.

## Best Practices

- Require the user to provide and verify the source endpoint or IPFS hash.
- Confirm indexing progress before changing the application endpoint.
- Use a stable tag so future deployments do not require frontend URL changes.

## Anti Patterns

- Do not guess a The Graph endpoint, IPFS hash, network, or deployment name.
- Do not declare success before the Goldsky index advances and the endpoint responds.
- Do not use this workflow to diagnose complex mapping or synchronization errors.

## Security Audit

- Audited at: 2026-09-28T16:22:09.556\+00:00
- Summary: The 38 external-command findings are false positives caused by Markdown backticks, code fences, and inline command examples in SKILL.md. The installer command at SKILL.md:55 pipes a remote script into a shell and is a confirmed critical supply-chain risk; the three hardcoded URLs are expected service or documentation endpoints, with the installer URL retaining a low network risk.

## Stats

- Views: 0
- Downloads: 1
- Favorites: 0
- Popularity score: 0