Official agent skill

Cloud SQL Basics

by google in google/skills

This file generates or explains Cloud SQL resources. An agent skill from google/skills.

OfficialApache-2.0Auto-check passedDatabases

Install Cloud SQL Basics

skills CLI
$ npx skills add google/skills --skill cloud-sql-basics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/skills cloud-sql-basics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cloud/cloud-sql-basics .claude/skills/cloud-sql-basics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cloud-sql-basics
GitHub stars
21k
Token cost
~973 tokens
SKILL.md length
343 words
Files
8 (incl. references)
Skills in repo
145
Repo updated
First seen
Licence
Apache-2.0

At a glance

This file generates or explains Cloud SQL resources. An agent skill from google/skills.

  • Works in 6 steps: Enable the API → Create an Instance → Set a password for the default user → …
  • Asks to create a Cloud SQL instance
  • SKILL.md covers Prerequisites, Quick Start (PostgreSQL) and Reference Directory
  • Calls gcloud

What it does

Cloud SQL Basics is an agent skill from google/skills, published by the product's own GitHub organization. This file generates or explains Cloud SQL resources. Use this file when the user asks to create a Cloud SQL instance or database for MySQL, PostgreSQL, or SQL Server. Cloud SQL manages third-party MySQL, PostgreSQL, and SQL Server instances as resources in Cloud SQL. For example, when Cloud SQL creates an open-source MySQL instance, the resulting resource is a Cloud SQL for MySQL instance that Google Cloud manages. Cloud SQL handles backups, high availability, and secure connectivity for relational database…

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/cli-usage.md`, `references/client-library-usage.md` and `references/core-concepts.md`).

It sits in Databases, covering SQL and Backup and disaster recovery. It works with SQL, PostgreSQL, MySQL and Microsoft SQL Server. The repository describes itself as: Agent Skills for Google products and technologies. The licence is Apache-2.0.

When your agent uses it

  • Asks to create a Cloud SQL instance
  • Database for MySQL

Example prompts

  • “/cloud-sql-basics”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Enable the API
  2. Create an Instance
  3. Set a password for the default user
  4. Create a database
  5. Get the instance connection name
  6. Connect to the instance

What it can do on your machine

Read from SKILL.md and the folder at commit 8a1ac05. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gcloud

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gcloud, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cloud SQL Basics loads about 973 tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 343 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~135
When it runs · the whole SKILL.md, loaded when a task matches
~973
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from google/skills at commit 8a1ac05, republished under its Apache-2.0 licence (© google). 343 words, ~973 tokens.

Download SKILL.mdSave it as .claude/skills/cloud-sql-basics/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
cloud-sql-basics
description
This file generates or explains Cloud SQL resources. Use this file when the user asks to create a Cloud SQL instance or database for MySQL, PostgreSQL, or SQL Server. Cloud SQL manages third-party MySQL, PostgreSQL, and SQL Server instances as resources in Cloud SQL. For example, when Cloud SQL creates an open-source MySQL instance, the resulting resource is a Cloud SQL for MySQL instance that Google Cloud manages. Cloud SQL handles backups, high availability, and secure connectivity for relational database workloads.
metadata.version
1.0.0
metadata.category
Databases

Cloud SQL Basics

Cloud SQL is a fully managed relational database service for MySQL, PostgreSQL, and SQL Server. It automates time-consuming tasks like patches, updates, backups, and replicas, while providing high performance and availability for your applications.

Prerequisites

Ensure you have the necessary IAM permissions to create and manage Cloud SQL instances. The Cloud SQL Admin (roles/cloudsql.admin) role provides full access to Cloud SQL resources.

Quick Start (PostgreSQL)

  1. Enable the API:

    bash
    gcloud services enable sqladmin.googleapis.com --quiet
  2. Create an Instance:

    bash
    gcloud sql instances create INSTANCE_NAME \
      --database-version=POSTGRES_18 \
      --cpu=2 \
      --memory=7680MiB \
      --region=REGION \
      --quiet
  3. Set a password for the default user:

    Because this is a Cloud SQL for PostgreSQL instance, the default admin user is postgres:

    bash
    gcloud sql users set-password postgres \
      --instance=INSTANCE_NAME --password=PASSWORD \
      --quiet
  4. Create a database:

    bash
    gcloud sql databases create DATABASE_NAME \
      --instance=INSTANCE_NAME \
      --quiet
  5. Get the instance connection name:

    You need the instance connection name (which is formatted as PROJECT_ID:REGION:INSTANCE_NAME) to connect using the Cloud SQL Auth Proxy. Retrieve it with the following command:

    bash
    gcloud sql instances describe INSTANCE_NAME \
      --format="value(connectionName)" \
      --quiet
  6. Connect to the instance:

    The Cloud SQL Auth Proxy must be running to be able to connect to the instance. In a separate terminal, start the proxy using the connection name:

    bash
    ./cloud-sql-proxy INSTANCE_CONNECTION_NAME

    With the proxy running, connect using psql in another terminal:

    bash
    psql "host=127.0.0.1 port=5432 user=postgres dbname=DATABASE_NAME password=PASSWORD sslmode=disable"

Reference Directory

  • Core Concepts: Cloud SQL editions (Enterprise & Enterprise Plus), instance architecture, read pools, high availability (HA), and supported database engines.

  • CLI Usage: Essential gcloud sql commands for instance, database, and user management.

  • Client Libraries & Connectors: Connecting to Cloud SQL using Python, Java, Node.js, and Go.

  • MCP Usage: Using the Cloud SQL remote MCP server and Gemini CLI extension.

  • Infrastructure as Code: Terraform configuration for instances, databases, and users.

  • IAM & Security: Predefined roles, SSL/TLS certificates, and Auth Proxy configuration.

  • Disaster Recovery & Backups: Backup types, Point-in-Time Recovery (PITR), replicas, read pools comparison, and Enterprise Plus Advanced DR.

If you need product information not found in these references, use the Developer Knowledge MCP server search_documents tool.

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in skills/cloud/cloud-sql-basics of google/skills.

  • SKILL.md
  • references/cli-usage.md
  • references/client-library-usage.md
  • references/core-concepts.md
  • references/dr-backups.md
  • references/iac-usage.md
  • references/iam-security.md
  • references/mcp-usage.md

Open the folder on GitHubat commit 8a1ac05

Compare with similar skills

Cloud SQL Basics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cloud SQL Basics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cloud SQL Basics this skillgoogle/skills21k—~973Automated safety check: PassApache-2.0
Cloud SQL Basicsdavila7/claude-code-templates32k—~810Automated safety check: PassMIT
GCP Cloud SQLsickn33/agentic-awesome-skills47k2 repos~2.4kAutomated safety check: PassMIT
Database Migrations SQL Migrationsrmyndharis/antigravity-skills1.7k2 repos~577Automated safety check: NotesMIT
SQL ProJeffallan/claude-skills12k—~1.3kAutomated safety check: PassMIT
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Cloud SQL Basics

    davila7/claude-code-templates

    Creates and manages Cloud SQL instances for MySQL, PostgreSQL, and SQL Server.

    32k GitHub stars~810 tokensUpdated today
    DatabasesAuto-check passed
  • GCP Cloud SQL

    sickn33/agentic-awesome-skills

    Provision Cloud SQL and Spanner databases. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.4k tokens
    DatabasesAuto-check passed
  • Database Migrations SQL Migrations

    rmyndharis/antigravity-skills

    SQL database migrations with zero-downtime strategies for PostgreSQL, MySQL, SQL Server

    1.7k GitHub starsUsed in 2 repos~577 tokens
    DatabasesAuto-check: notes
  • SQL Pro

    Jeffallan/claude-skills

    Optimizes SQL queries and designs schemas using CTEs, window functions, covering indexes and EXPLAIN ANALYZE, with notes on dialect differences between major databases.

    12k GitHub stars~1.3k tokensUpdated 4 days ago
    DatabasesAuto-check passed
  • SQL Optimization

    github/awesome-copilot

    Official

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server…

    40k GitHub starsUsed in 2 repos~2.3k tokens
    DatabasesAuto-check passed
  • Relational Database MCP Cloudbase

    TencentCloudBase/CloudBase-AI-Toolkit

    [Deprecated] This is the required documentation for agents operating on the CloudBase Relational Database through MCP.

    1.1k GitHub starsUsed in 1 repo~2.5k tokens
    DatabasesAuto-check passed

More from google/skills

All 145 skills in this repo
  • Official

    Manages Google Cloud Privileged Access Manager entitlements and grants: create and edit entitlements, request temporary access, and approve or deny pending grants.

    21k GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • Official

    Writes Terraform alerting policies for AI agents that emit OpenTelemetry metrics, covering reliability, cost, safety, security and quality signals on Google Cloud.

    21k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Official

    Deploys open models or custom weights from Model Garden to Agent Platform endpoints, checks deployment status and cleans up endpoints, confirming before any change.

    21k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Official

    Searches, manages and scaffolds skills in the Gemini Enterprise Agent Platform Skill Registry using bundled Python scripts and Google Cloud credentials.

    21k GitHub stars~584 tokensUpdated yesterday
    Auto-check passed
  • Designs GCP infrastructure as local Terraform, validates and scans it against best practices, then imports it to Application Design Center for deployment and troubleshooting.

    21k GitHub stars~4.4k tokensUpdated yesterday
    Auto-check passed
  • Official

    Analyzes BigQuery slot use, query costs and execution bottlenecks from INFORMATION_SCHEMA to diagnose slow queries, slot contention and unpartitioned scans.

    21k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Cloud SQL Basics

What does Cloud SQL Basics do?

This file generates or explains Cloud SQL resources. An agent skill from google/skills. Cloud SQL Basics is an agent skill from google/skills, published by the product's own GitHub organization. This file generates or explains Cloud SQL resources.

When should I use Cloud SQL Basics?

Cloud SQL Basics fits situations like: asks to create a Cloud SQL instance; database for MySQL.

How do I install Cloud SQL Basics in Claude Code?

Run `npx skills add google/skills --skill cloud-sql-basics -a claude-code`. Or copy the skill folder (skills/cloud/cloud-sql-basics in google/skills) into .claude/skills/cloud-sql-basics in your project. Claude Code loads it when a task matches its description.

How do I install Cloud SQL Basics in Codex?

Run `npx skills add google/skills --skill cloud-sql-basics -a codex`. Or copy the skill folder (skills/cloud/cloud-sql-basics in google/skills) into .agents/skills/cloud-sql-basics in your project. Codex loads it when a task matches its description.

Can I use Cloud SQL Basics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/skills --skill cloud-sql-basics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cloud-sql-basics, .gemini/skills/cloud-sql-basics, .github/skills/cloud-sql-basics and .opencode/skills/cloud-sql-basics in your project.

What does Cloud SQL Basics need to run?

Going by SKILL.md and its folder, Cloud SQL Basics needs the command-line tools its instructions call (gcloud). Our summary lists: Node.js.

Does Cloud SQL Basics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cloud SQL Basics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cloud SQL Basics use?

Cloud SQL Basics is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cloud SQL Basics use?

About 973 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.6k tokens, read only when the agent opens those files.

What are the alternatives to Cloud SQL Basics?

Skills that share tags, products or a category with Cloud SQL Basics: Cloud SQL Basics (davila7/claude-code-templates, 32k stars), GCP Cloud SQL (sickn33/agentic-awesome-skills, 47k stars), Database Migrations SQL Migrations (rmyndharis/antigravity-skills, 1.7k stars) and SQL Pro (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cloud SQL Basics?

google (a GitHub organization, an official publisher) maintains it in google/skills, which has 20,994 GitHub stars. The repository holds 145 skills in this directory. The repository was last updated on October 6, 2026.

Source: google/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.