> ## Documentation Index > Fetch the complete documentation index at: https://docs.goldsky.com/llms.txt > Use this file to discover all available pages before exploring further. # AI Skills > AI skills for building, deploying, and debugging Goldsky Turbo, Mirror, Subgraphs, Compose, and Edge with Claude Code, Cursor, and other AI coding assistants ## Overview [Goldsky Agent](https://github.com/goldsky-io/goldsky-agent) is a skill pack for AI coding assistants that helps you build, deploy, and debug across the full Goldsky product surface — Turbo pipelines, Mirror pipelines, Subgraphs, Compose, and Edge RPC. Skills auto-trigger based on what you describe — no slash commands required. Interactive workflow skills walk you through multi-step tasks end-to-end. Reference skills provide YAML syntax, manifest fields, error patterns, and CLI commands on demand. Works with Claude Code, Cursor, Windsurf, OpenCode, Codex, and other AI coding assistants. ## Quick start | I want to... | Use | | --------------------------------------------------- | -------------------- | | Build a new Turbo pipeline | `/turbo-builder` | | Fix a broken Turbo pipeline | `/turbo-doctor` | | Fix a broken Mirror pipeline | `/mirror-doctor` | | Fix a broken Compose app | `/compose-doctor` | | Find the right dataset name | `/datasets` | | Look up Turbo YAML syntax | `/turbo-pipelines` | | Look up Compose manifest, CLI flags, or TaskContext | `/compose-reference` | | Set up the CLI and log in | `/auth-setup` | Just describe what you need in natural language — the right skill is selected automatically. ## Installation Installs to Claude Code, Cursor, and 30+ other AI agents: ```bash theme={null} npx skills add goldsky-io/goldsky-agent ``` ``` /plugin marketplace add goldsky-io/goldsky-agent /plugin install goldsky@goldsky-agent ``` ```bash theme={null} git clone https://github.com/goldsky-io/goldsky-agent.git claude --plugin-dir ./goldsky-agent ``` Clone the repo and add the path to Cursor settings (`Settings > Cursor Settings > JSON`): ```bash theme={null} git clone https://github.com/goldsky-io/goldsky-agent.git ``` ```json theme={null} { "plugins.local": ["/absolute/path/to/goldsky-agent"] } ``` ```bash theme={null} git clone https://github.com/goldsky-io/goldsky-agent.git cp -r goldsky-agent/skills/* .claude/skills/ # Claude Code cp -r goldsky-agent/skills/* .cursor/skills/ # Cursor ``` ## Available skills Skills are grouped by product. Each group has interactive workflow skills (guided, multi-step) and/or reference skills (lookup-oriented). ### Turbo pipelines Streaming pipelines that index onchain data from 130+ chains into PostgreSQL, ClickHouse, Kafka, S3, and more. | Skill | When to use | What it does | | ------------------ | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | `turbo-builder` | "I want to build a pipeline for X" | Guides you through chain → dataset → transforms → sink → validate → deploy | | `turbo-doctor` | "My pipeline is broken / not getting data / output looks wrong" | Diagnoses the problem step-by-step and offers to run fixes | | `turbo-pipelines` | "What's the YAML syntax for X? Should I use dataset or Kafka?" | Source/transform/sink field reference and architecture decisions (flow patterns, sizing, sink selection) | | `turbo-transforms` | "How do I decode EVM logs / write a SQL transform?" | SQL, TypeScript/WASM, dynamic tables, HTTP handlers | | `turbo-operations` | "How do I pause / restart / delete? What does this error mean?" | Lifecycle commands, pipeline states, CLI monitoring, error patterns | ### Mirror pipelines Goldsky's original streaming pipeline product — the only one that supports subgraph entity sources. | Skill | When to use | What it does | | --------------- | ----------------------------------------------------------- | ------------------------------------------------------------------ | | `mirror` | "How do I sync my subgraph to PostgreSQL? Mirror vs Turbo?" | Sources, sinks, lifecycle commands, Mirror vs Turbo guidance | | `mirror-doctor` | "My Mirror pipeline is failing / stuck / terminated" | Runs status and log commands, identifies root cause, applies fixes | ### Subgraphs Hosted GraphQL APIs for dApp frontends. For most other use cases, prefer Turbo — it's faster, cheaper, and more reliable. Use subgraphs when you specifically need a GraphQL endpoint. | Skill | When to use | What's inside | | ----------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | | `subgraphs` | "Deploy a subgraph / migrate from The Graph / manage GraphQL endpoints" | Deploy paths, GraphQL endpoints, tags, webhooks, cross-chain patterns | ### Compose Offchain-to-onchain TypeScript framework for oracles, keepers, circuit breakers, and cross-chain automation. | Skill | When to use | What it does | | ------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | | `compose` | "Build a price oracle / keeper / cross-chain bot in TypeScript" | Walks through scaffolding, task triggers (cron, HTTP, onchain), wallets, gas sponsorship | | `compose-doctor` | "My Compose app is in error state / crashlooping / not processing tasks" | Runs `status`, `logs`, `secret list`, `wallet list` and diagnoses | | `compose-reference` | "What fields does `compose.yaml` accept? What's the `TaskContext` API?" | Manifest fields, every `goldsky compose` flag, TaskContext / wallet / Collection APIs, codegen, pricing | ### Edge (managed RPC) Globally distributed, low-latency JSON-RPC for EVM chains, built on eRPC with intelligent routing, caching, and failover. | Skill | When to use | What's inside | | ------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | | `edge` | "RPC rate limits, hedged requests, flashblocks, x402, error code -32005" | Capabilities, supported chains, pricing, dashboard, error code reference | ### Cross-cutting Used across multiple products. | Skill | When to use | What it does | | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | | `auth-setup` | "Install the CLI / log in / switch projects / fix unauthorized errors" | Walks through CLI installation, login, and project switching | | `secrets` | "Create credentials for PostgreSQL / ClickHouse / Kafka / webhook sinks" | Guides credential creation and secret management | | `datasets` | "What's the dataset name for Polygon NFTs? What prefix does Solana use?" | Chain prefixes, dataset types, naming conventions | | `cli-reference` | Consulted automatically before any `goldsky` command | All valid subcommands, arguments, and flags — generated from the installed CLI | ## How it works Skills are automatically discovered by your AI assistant and triggered based on what you describe. You don't need to invoke them by name. ``` User: "Build me a pipeline for USDC transfers on Base" ↓ turbo-builder (auto-triggered) ↓ references turbo-pipelines + datasets + secrets ↓ Generated pipeline.yaml + deployment ``` Interactive skills (`turbo-builder`, `turbo-doctor`, `mirror-doctor`, `compose-doctor`) run as agents with access to CLI tools. Reference skills provide structured knowledge that the AI uses to answer questions or generate YAML. ## Repository structure ``` goldsky-agent/ ├── skills/ │ ├── turbo-builder/ # Step-by-step pipeline creation wizard │ ├── turbo-doctor/ # Diagnose and fix Turbo pipeline issues │ ├── turbo-pipelines/ # YAML configuration + architecture reference │ ├── turbo-transforms/ # SQL, TypeScript, dynamic tables │ ├── turbo-operations/ # Lifecycle, monitoring, error patterns │ ├── mirror/ # Mirror pipeline deploy, operate, reference │ ├── mirror-doctor/ # Diagnose and fix Mirror pipelines │ ├── subgraphs/ # Subgraph deploy, GraphQL endpoints, tags │ ├── compose/ # Compose app scaffolding, triggers, wallets │ ├── compose-doctor/ # Diagnose and fix Compose apps │ ├── compose-reference/ # compose.yaml fields, CLI flags, TaskContext API │ ├── edge/ # Managed RPC capabilities, error codes, pricing │ ├── datasets/ # Chain prefixes, dataset types │ ├── secrets/ # Credential management │ ├── auth-setup/ # CLI installation, login │ └── cli-reference/ # Valid CLI commands + flags (auto-generated) ├── scripts/ │ └── generate-cli-reference.js # Regenerates cli-reference from installed CLI ├── hooks/ │ └── scripts/ # Validation, secret checking └── .claude-plugin/ # Plugin manifest ``` ## Pre-deploy hooks When installed as a plugin, Goldsky Agent runs hooks automatically on `goldsky turbo apply` commands: | Hook | What it does | | --------------------- | ------------------------------------------------ | | `pre-deploy-validate` | Runs `goldsky turbo validate`, blocks on failure | | `secret-check` | Verifies all `secret_name` references exist | | `post-deploy-inspect` | Suggests `goldsky turbo inspect` after deploy | ## Coverage The skills cover the full Goldsky product surface: * **Turbo pipelines** — 130+ chain sources (EVM, Solana, Bitcoin, Stellar, Sui, NEAR, Starknet); SQL / TypeScript / dynamic table transforms; PostgreSQL, ClickHouse, Kafka, S3, Webhook, S2, SQS, MySQL, Pub/Sub sinks; streaming and job modes; full lifecycle and monitoring * **Mirror pipelines** — Subgraph and direct-indexing sources, sinks, lifecycle, plus interactive diagnosis * **Subgraphs** — Deploy, tags, webhooks, cross-chain, migration from The Graph * **Compose** — `compose.yaml` manifest, cron / HTTP / onchain triggers, smart wallets, gas sponsorship, `TaskContext` API, codegen, pricing * **Edge RPC** — Capabilities, supported chains, hedged requests, flashblocks, x402, error code lookups * **Cross-cutting** — Authentication, secrets, dataset naming, full CLI reference ## Example prompts Once installed, describe what you need in natural language: * "Build a Turbo pipeline to track USDC transfers on Base" * "My pipeline is stuck in error state — help me fix it" * "Sync my subgraph entities to PostgreSQL with a Mirror pipeline" * "Build a Compose task that runs a price oracle every 5 minutes" * "My Compose app is returning 500 on the HTTP trigger — what's wrong?" * "Why am I getting RPC error -32005 on Edge?" * "What's the dataset name for Polygon ERC-20 transfers?" * "Show me the YAML syntax for a ClickHouse sink" * "Configure a PostgreSQL secret for my pipeline" * "Set up the Goldsky CLI and authenticate" ## Related resources * [Goldsky Agent repository](https://github.com/goldsky-io/goldsky-agent) — Full source code and documentation * [MCP server](/mcp-server) — Connect Goldsky documentation to AI tools for real-time doc search