Skills for Cortex Code

In addition to the Cortex Agent Integration, Neo4j provides an Agent Skill for Neo4j Graph Analytics for Snowflake. The skill packages the knowledge needed to run graph algorithms inside Snowflake — the strict view and column-type rules, the explore → prepare projection views → project-compute-write → inspect flow, and the exact SQL CALL syntax for every algorithm — so that AI coding agents such as Cortex Code can help you write and troubleshoot Graph Analytics workloads.

The skill is distributed through the public neo4j-skills repository, not the Snowflake Marketplace. Distributing skills through the Marketplace is not currently supported.

What the skill covers

  • Installing Neo4j Graph Analytics from the Snowflake Marketplace and setting up the required privileges and roles.

  • The end-to-end flow: explore the source data, prepare graph-ready projection views, run the algorithm with a single CALL, and inspect the results.

  • The strict view/column type rules the graph engine requires (key columns, supported property types, casting).

  • Exact SQL CALL syntax for all available graph algorithms, plus projection configuration (node tables, relationship tables, orientation).

  • Looking up human-readable names by joining results back to source tables, chaining algorithms together, and troubleshooting common errors.

Where to find the skill

The skill lives in the neo4j-contrib/neo4j-skills repository:

github.com/neo4j-contrib/neo4j-skills/tree/main/neo4j-snowflake-graph-analytics-skill

The skill directory contains:

  • SKILL.md — the skill instructions and frontmatter (name, description, allowed-tools).

  • README.md — an overview of what the skill covers and a quick example.

  • references/ — additional reference material loaded on demand, such as algorithms.md with the full algorithm catalog and CALL syntax.

Deploy the skill to Cortex Code

A skill is a folder containing a SKILL.md file (plus the optional references/ directory), which is exactly this directory’s layout. Install it into Cortex Code Desktop or the Cortex Code CLI.

Cortex Code Desktop

Add the skill straight from GitHub:

  1. Open Agent Settings → Skills.

  2. In the GitHub Skills section, click + (Add from GitHub).

  3. Enter the skill’s path in the repository:

    https://github.com/neo4j-contrib/neo4j-skills/tree/main/neo4j-snowflake-graph-analytics-skill

  4. Click Add.

You can also add it as a Local skill (point Add Local Skill at a folder containing this skill directory) or from a Snowflake Stage (@DATABASE.SCHEMA.STAGE/…​).

Cortex Code CLI

Register the skill from a Git repository, a local folder, or a Snowflake stage:

/skill add <path to skill folder>

Alternatively, drop the skill folder into a directory the CLI scans — project scope .cortex/skills/ or user scope ~/.snowflake/cortex/skills/.

Verify and use the skill

List the available skills to confirm the skill was loaded:

/skill list

The neo4j-snowflake-graph-analytics-skill should appear in the listing. Once it is added, Cortex Code invokes the skill automatically when your prompt matches its description, or you can trigger it explicitly with $neo4j-snowflake-graph-analytics-skill in the conversation.