{
  "markdown": "# Data Agent Kit Starter Pack\n\n> [!NOTE]\n> This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).\n\nThis plugin provides a specialized suite of skills and MCP tools for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, create and troubleshoot Dataflow pipelines, and orchestrate end-to-end workflows across the Google Cloud data ecosystem (BigQuery, Spanner, BigLake, Dataproc, etc.).\n\n> [!IMPORTANT]\n> **We Want Your Feedback!**\n> Please share your thoughts with us by opening an issue on GitHub. Your input is invaluable and helps us improve the project for everyone.\n\n## Contents\n\n- [Why Use the Data Agent Kit Starter Pack?](#why-use-the-data-agent-kit-starter-pack)\n- [Prerequisites](#prerequisites)\n- [Getting Started](#getting-started)\n  - [Installation](#installation)\n  - [Configuration](#configuration)\n- [Usage Examples](#usage-examples)\n- [Troubleshooting](#troubleshooting)\n- [Security Reminder: Agent Environment Hardening](#security-reminder-agent-environment-hardening)\n\n## Why Use the Data Agent Kit Starter Pack?\n\n* **Seamless Workflow:** Bring Google Cloud data engineering expertise directly into your terminal or IDE via Gemini CLI, Claude Code, or Codex.\n* **End-to-End Data Pipelines:** Effortlessly generate code that reads raw data from Cloud Storage, processes it with Spark, Dataflow or BigQuery, transforms it through medallion architectures (bronze, silver, gold) using dbt, and exports it to serving layers like Spanner.\n* **Ecosystem Integration:** Work across boundaries—generate BigLake Iceberg catalog tables, train BigQuery ML models (XGBoost, KMEANS), and create interactive Streamlit dashboards or LookML models, all from natural language.\n* **Workflow Orchestration:** Automatically create and schedule orchestration pipelines that tie your notebooks and dbt models together into robust, scheduled jobs.\n\n## Prerequisites\n\nEnsure you have the following installed:\n* **Node.js and npm** (Latest version recommended)\n* **Google Cloud SDK (gcloud CLI):** [Install and initialize](https://cloud.google.com/sdk/docs/install) the gcloud CLI and ensure [Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/provide-credentials-adc) are configured.\n* One of the following coding agents:\n    * Antigravity CLI\n    * [Gemini CLI](https://github.com/google-gemini/gemini-cli) (v0.6.0+)\n    * [Claude Code](https://code.claude.com/docs)\n    * Codex CLI\n* **(Optional) IDE Extension:** [Google Cloud Data Agent Kit](https://docs.cloud.google.com/data-cloud-extension/vs-code/install).\n\n## Getting Started\n\n<!-- {x-release-please-start-version} -->\n\n### Installation\n\nChoose the installation method for your preferred coding agent. Run the commands in terminal\n\n<details>\n<summary><b>Antigravity CLI</b></summary>\n\nInstall the plugin directly from GitHub:\n```bash\nagy plugin install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack\n```\n</details>\n\n<details>\n<summary><b>Gemini CLI and Gemini Code Assist</b></summary>\n\nInstall the extension directly from GitHub:\n```bash\ngemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack --ref 0.10.1\n```\n</details>\n\n<details>\n<summary><b>Claude Code</b></summary>\n\nRun the `claude` command to start the agent, then follow these steps:\n\n1. **Install the plugin:**\n```bash\n/plugin install data-agent-kit-starter-pack@claude-plugins-official\n```\n</details>\n\n<details>\n<summary><b>Codex</b></summary>\n\n#### Option 1: Marketplace Installation (Recommended)\n\nCodex utilizes a marketplace system for plugins. Install the Data Agent Kit Starter Pack marketplace to access the plugin:\n\n```bash\n# Step 1. Add marketplace\ncodex plugin marketplace add https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack\n\n# Step 2. Add the plugin\ncodex plugin add dak@data-agent-kit-starter-pack-marketplace\n```\n\n#### Option 2: Script Installation (Alternative)\n\n1. **Run the installation script in your terminal:**\n\n**macOS / Linux:**\n```bash\nCODEX_TAG=\"0.10.1\"; curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/$CODEX_TAG/codex-install.sh | bash -s -- $CODEX_TAG\n```\n\n**Windows:**\n```powershell\n$env:CODEX_TAG=\"0.10.1\"; irm \"https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/$env:CODEX_TAG/codex-install.ps1\" | iex\n```\n\n2. **Install the plugin in Codex:**\n\nStart the Codex agent (`codex`), then run:\n```bash\n/plugins\n```\nUse the interactive options to install the plugin with the name `Data Agent Kit Starter Pack`.\n</details>\n\n<details>\n<summary><b>Any Agent Plugins–compatible client</b></summary>\n\nThis repository is a valid [Agent Plugins](https://github.com/agentplugins/agent-plugins-spec) (v1) plugin. Any [compatible client](https://agent-plugins.org/compatible-clients) (VS Code, Cursor, GitHub Copilot, Codex, Kiro, …) can install it directly using its own built-in plugin command — skills and MCP servers included — by pointing at this repository:\n```\nhttps://github.com/gemini-cli-extensions/data-agent-kit-starter-pack\n```\nSee your agent's documentation for its exact install command.\n</details>\n\n### Configuration\n\nThis extension brings a suite of specialized **Skills** and **MCP toolboxes**. While skills are ready to use upon installation, you **must** configure the MCP toolboxes and authenticate with Google Cloud for them to start successfully.\n\n> [!NOTE]\n> If you use Gemini CLI, Claude Code, or Codex in your IDE (e.g., via VS Code extensions), they share the same underlying configuration and MCP servers as the CLI agents.\n\n#### 1. Authenticate with Google Cloud\nThe MCP toolboxes require an active authenticated session to interact with your resources. Run the following commands in your terminal:\n```bash\ngcloud auth login\ngcloud auth application-default login\n```\n\n#### 2. Update Agent Configuration\nYou must configure the MCP toolboxes in your agent's configuration files for them to start successfully. After updating, you must restart the agent.\n\nTo verify your configuration:\n* Run the `/mcp` command to check the status of available MCP servers.\n* Ask your agent \"What skills are available?\" to view the list of active skills.\n\n<details>\n<summary><b>Antigravity CLI</b></summary>\n\nEdit the configuration file:\n`~/.gemini/antigravity-cli/plugins/data-agent-kit-starter-pack/mcp_config.json`\n</details>\n\n<details>\n<summary><b>Gemini CLI and Gemini Code Assist</b></summary>\n\nEdit the configuration file:\n`~/.gemini/extensions/data-agent-kit-starter-pack/gemini-extension.json`\n</details>\n\n<details>\n<summary><b>Claude Code</b></summary>\n\nEdit the configuration file:\n`~/.claude/plugins/cache/claude-plugins-official/data-agent-kit-starter-pack/0.10.1/.claude-mcp.json`\n</details>\n\n<details>\n<summary><b>Codex</b></summary>\n\n1. Edit the configuration file:\n`~/.codex/plugins/cache/data-agent-kit-starter-pack-marketplace/dak/0.10.1/.mcp.json`\n\n2. Restart Codex.\n</details>\n\n<!-- {x-release-please-end} -->\n<!-- github-release-force: 0.10.1 -->\n\n## Usage Examples\n\nInteract with your coding agent using natural language prompts to perform complex data engineering tasks:\n\n* **Data Ingestion & Processing:**\n  * \"Create a Spark notebook that reads raw fraud transaction data from gs://fin-clearing-west1/raw, deduplicates records, and writes hourly partitions to a BigLake Iceberg catalog table.\"\n  * \"Create a BigQuery SQL notebook that drops an existing table and writes deduplicated transaction data from GCS.\"\n* **Data Transformation (dbt):**\n  * \"Create a dbt pipeline to transform bronze_transactions into silver and gold tables, standardizing timestamps and joining with identity tables.\"\n* **Machine Learning & Serving:**\n  * \"Train a robust XGBoost model using BigQuery ML on the gold_transactions table to identify potential fraud.\"\n  * \"Generate an inference notebook to batch-process new partitions and write flagged transactions into a Cloud Spanner table for high-availability access.\"\n* **Analysis & Visualization:**\n  * \"Generate a complete View for my BigQuery tables to show YoY revenue growth, then generate a LookML model and an interactive Streamlit dashboard prototype.\"\n* **Orchestration:**\n  * \"Create an orchestration pipeline that first runs the dedup notebook, then the dbt pipeline, and finally the model training and inference notebooks. Schedule it to run every Monday morning.\"\n\n\n## Troubleshooting\n\nUse `gemini --debug` to enable debugging.\n\nCommon issues:\n\n* **Plugin Not Found:** Ensure you have restarted your agent (e.g., Gemini CLI or Codex) after installation.\n* **Authentication Errors:** Many GCP skills require an active authenticated session. Ensure you have run `gcloud auth login` and `gcloud auth application-default login` on your machine. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc) for more information.\n* **\"failed to find default credentials: google: could not find default credentials.\"**: Ensure Application Default Credentials (ADC) are available in your environment.\n* **MCP Connection Issues:** Update the MCP server configurations such as project, region etc. needed by MCP toolboxes in order to connect successfully to them.\n* **\"✖ Error during discovery for server: MCP error -32000: Connection closed\"**: The connection could not be established. Ensure your configuration is correctly set in the agent's configuration file.\n* **\"✖ MCP ERROR: Error: spawn .../toolbox ENOENT\"**: The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.\n* **\"cannot execute binary file\"**: The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded.\n\n## Security Reminder: Agent Environment Hardening\n\nYour agent can execute tools and commands on your behalf. Protect your Google\nCloud resources by enforcing **The Principle of Least Privilege** across all\nCLIs, MCP servers and other resources available to your agents.\n\n*   **Service Accounts:** Use\n    [service accounts](https://cloud.google.com/docs/authentication/use-service-account-impersonation)\n    instead of end user credentials to access Google Cloud resources.\n*   **Limited Permissions:** Assign roles with\n    [limited permissions](https://cloud.google.com/iam/docs/roles-overview)\n    to the service account that you're using for authentication.\n*   **Principal Access Boundaries:** Prevent unwanted cross-org agent access by\n    using\n    [Principal Access Boundary policies](https://cloud.google.com/iam/docs/principal-access-boundary-policies#use-case-one-project)\n    to scope your agent to projects you intend it to access.\n*   [Include a condition in the policy binding](https://cloud.google.com/iam/docs/principal-access-boundary-policies#use-case-one-project)\n    to ensure that the policy only applies to the service accounts that you\n    intend to restrict.\n\nYou can read more\n[here](https://docs.cloud.google.com/data-cloud-extension/vs-code/prompt-injection-risk)\non how to mitigate prompt injection attacks with Google Cloud MCP.\n\n## Usage Statistics\n\nThe Data Agent Kit collects usage statistics (such as when the skills and\nMCP tools included in this kit are used) to improve the reliability and\nperformance of the tool. No user code, file contents, or application data\nvalues are collected.\n\n### Opting Out\n\nYou can opt out of usage statistics collection at any time using one of the\nfollowing methods:\n\n#### 1. Environment Variable\nSet the `DO_NOT_TRACK` environment variable to `1` in your environment:\n```bash\nexport DO_NOT_TRACK=1\n```\n\n#### 2. Configuration File\nCreate or update your configuration file at `~/.data_agent_kit/config.json` to\ndisable collection:\n```json\n{\n  \"enableTelemetry\": false\n}\n```\n",
  "bytes": 12030,
  "sha": "f4675033f601b73d7f75f15c54a5203816c4da17953bb0ff1087a29481fdb4a3",
  "repo_slug": "gemini-cli-extensions/data-agent-kit-starter-pack",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gemini_cli_extensions_data_agent_kit_sta_3330a7a9/readme"
}