skills-sync_skill

Overview

This skill manages and synchronizes AI agent skills from local skill directories and remote Git repositories. It consolidates discovered skills, validates them, and generates Cursor-compatible Agent Skills XML rules for IDE integration. Use it to establish and maintain a consistent skills catalog across machines and projects.

How this skill works

The tool scans prioritized local skill locations and reads a central repos.txt to collect remote Git URLs. It clones or updates each repository into a cache, extracts skill definition files from expected paths, and places normalized copies into a centralized skills directory. Finally, it validates skills with the Agent Skills validator and writes an embedded <available_skills> XML block into Cursor rules so the IDE can load skills automatically.

When to use it

• Onboard new or updated skills from remote Git sources into your local environment
• Ensure project-level skills override global skills using defined precedence
• Bootstrap or refresh Cursor IDE skill rules after adding or removing skills
• Automate validation and normalization of skill metadata before use
• Synchronize skills across developer machines or CI environments

Best practices

• Keep a single repos.txt per project or user location to manage remote skill sources
• Place project-specific skills in the project skill directory to ensure higher precedence
• Use clear frontmatter metadata in skill definition files (name, description) for reliable extraction
• Run the sync regularly or integrate into CI to catch outdated or invalid skills early
• Remove URLs from repos.txt to stop syncing a remote source, then optionally delete extracted skills

Example use cases

• Add a shared team skills repo URL to repos.txt to make team skills available locally
• Develop a new skill in a project skill directory to override a global skill with the same name
• Run the sync in CI to validate skills and update Cursor rules before deployment
• Clean up deprecated skills by removing their URLs and rerunning the sync
• Migrate skills from multiple sources into a single ~/.snowflake/cortex/skills/ store for tooling consumption