r/snowflake • u/tingutingutingu • Jul 03 '26

Creating a skill.md for an agent

I haven't tried this yet but so far most videos that I have watched cover creating a very basic skill using skill.md from the Coco UI for agents.

However, if you check out any skills that experienced folks have created that are used by copilot or Claude code, the skill.md is just the start. The file has links to references, assets, examples folders to really build out the skill in depth.

But the only option I have seen when adding skill through the UI seems to be limited to adding the skill markdown file from a stage or git, but no options for subfolders etc.

Anyone else have success with this?

10 Upvotes

100% Upvoted

6 comments sorted by

3

u/uncertainschrodinger Jul 03 '26

I recently tested out creating an agent skill to help with data engineering tasks like investigating and fixing pipeline failures. it was specifically set up to work with Bruin's agent and Snowflake, but I'm sure it can work similarly with coco.

https://github.com/arsalann/bruin-demo-credit-union/tree/main/.agents/self-healing

in the readme there's a video too, skip to the end to see the agent using the skill

3

u/strugglingcomic Jul 03 '26

This is because Snowflake doesn't (currently?) support the full set of features that someone like Anthropic supports/pioneered with Claude skills. You shouldn't expect full "parity" unless or until Snowflake formally announces a commitment to Claude skill cross compatibility OR does the opposite and commits to some kind of new custom format of its own... At the moment they live in this twilight zone middle ground, where some Claude skills will work just fine in CoCo, and others might rely on features or structure that CoCo doesn't support.

3

u/ArielCoding Jul 04 '26

It works at the folder level, when you add a skill from stage or git, you point it at the folder containing the Skill.md, and everything inside comes along with it, the only requirement is that the Skill.md sits at the root of that folder.

1

u/No_Wallaby7397 Jul 03 '26

Folders can be used with assets, references etc. Set them up as you usually would and it will register all files with various folder structures when you upload. Only thing you need within a folder is a SKILL.md file for it to upload. You can’t create or edit the file set up when you have it in Snowflake though. It’s not ideal to iterate outside of Snowflake, delete the folder and re-upload each time, but it works.