AI Assistant Integration

Paid edition only. The AI coding assistant skill requires the SQL Procedures API, which is available with the paid edition of Geo Data Connector.

The CoCo Skill is a companion skill available for Snowflake CoCo (formerly Cortex Code) and Claude Code users. It provides your AI coding assistant with knowledge of the SQL Procedures API, ingested data schema, and geospatial query patterns.

Prerequisites

Before installing the skill, make sure your Snowflake account and user meet CoCo's requirements:

• Role grants — using CoCo requires the SNOWFLAKE.COPILOT_USER database role plus either SNOWFLAKE.CORTEX_USER or SNOWFLAKE.CORTEX_AGENT_USER. SNOWFLAKE.CORTEX_USER is granted to all users through the PUBLIC role by default, but your organization may have revoked it.

• Cross-region inference — CoCo needs access to a region where its models are available. If cross-region inference is disabled in your account (the default), an ACCOUNTADMIN must enable it:

  ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'ANY_REGION';

See the CoCo documentation for details on editions, billing, and delivery methods (Snowsight, Desktop, CLI).

Installation

Snowsight (CoCo chat):

1. Download the skill file geo-data-connector/SKILL.md from the skill repository and rename it to geo-data-connector.md.
2. In your Snowsight workspace, open the CoCo chat, select the + (add content) menu, and choose Upload Skill File(s). The file is stored in the workspace folder .snowflake/cortex/skills.
3. Ask CoCo to load the skill:

check skills in workspace skills folder

TIP

Skills uploaded this way belong to the workspace where you uploaded them. Start each new chat with check skills in workspace skills folder so CoCo picks up the skill.

CoCo CLI:

cortex skill add https://github.com/smartdatahub/gdc-snowflake-skills.git

Claude Code:

/skill add https://github.com/smartdatahub/gdc-snowflake-skills.git

Updating

Snowsight: Download the latest skill file from the repository and upload it to the workspace again, replacing the previous file.

CoCo CLI:

cortex skill update smartdatahub/gdc-snowflake-skills

Claude Code:

/skill sync

Usage

Once installed, the CoCo Skill activates automatically when you ask about Geo Data Connector procedures or ingested geospatial data. You can also invoke it directly using the $ shortcut:

$geo-data-connector list settings

Routing prompts to the CoCo Skill

Include the keyword gdc in your prompt to help the assistant recognize that the task belongs to the CoCo Skill. For example:

• show gdc settings
• show gdc tasks
• search gdc for buildings in Finland
• create a gdc ingestion task for this WFS service