skills-sync
Manage and synchronize AI agent skills from local SKILL.md files and remote Git repositories, generating Cursor rules with Agent Skills specification XML. This skill should be used when users need to sync skills, add/remove skill repositories, or set up the skills infrastructure.
Best use case
skills-sync is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Manage and synchronize AI agent skills from local SKILL.md files and remote Git repositories, generating Cursor rules with Agent Skills specification XML. This skill should be used when users need to sync skills, add/remove skill repositories, or set up the skills infrastructure.
Teams using skills-sync should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/skills-sync/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How skills-sync Compares
| Feature / Agent | skills-sync | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Manage and synchronize AI agent skills from local SKILL.md files and remote Git repositories, generating Cursor rules with Agent Skills specification XML. This skill should be used when users need to sync skills, add/remove skill repositories, or set up the skills infrastructure.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Skills Sync ## Overview Synchronizes AI agent skills from local directories and Git repositories, generating `.cursor/rules/skills.mdc` for Cursor IDE integration. ## Usage **First time setup** (installs uv if needed, then installs skills-sync as a tool): ```bash python3 .claude/skills/skills-sync/scripts/skills_sync.py ``` **Subsequent runs:** ```bash skills-sync ``` The script auto-detects the project root by walking up the directory tree. ## Skill Locations (Precedence Order) | Priority | Location | Type | | ----------- | ----------------------------- | ------- | | 1 (highest) | `$PROJECT/.cortex/skills/` | Project | | 2 | `$PROJECT/.claude/skills/` | Project | | 3 | `~/.snowflake/cortex/skills/` | Global | | 4 (lowest) | `~/.claude/skills/` | Global | Higher precedence locations override skills with the same name from lower locations. ## Repository Configuration Place `repos.txt` in any skill directory to sync skills from Git repositories: ```text https://github.com/anthropics/skills https://github.com/your-org/your-skills-repo # Comments start with # ``` The script checks all four skill locations for `repos.txt` files and deduplicates URLs. ### Repository Skill Extraction Skills are extracted ONLY from `.cortex/skills/*/SKILL.md` and `.claude/skills/*/SKILL.md` paths within repositories. Extracted skills are placed in `~/.snowflake/cortex/skills/` with a repo prefix (e.g., `skills-dbt-core/`). ## Managing Repositories **Add Repository:** Add URL to `repos.txt`, run `skills-sync` **Remove Repository:** Delete URL from `repos.txt`, run `skills-sync`, optionally delete extracted skills from `~/.snowflake/cortex/skills/<repo>-<skill>/` ## Output The script generates `.cursor/rules/skills.mdc` containing `<available_skills>` XML that Cursor loads automatically for all AI interactions. ## Sync Process 1. Read `repos.txt` from all locations, deduplicate URLs 2. Clone/update repositories to `~/.snowflake/.cache/repos/` 3. Extract skills to `~/.snowflake/cortex/skills/` with repo prefix 4. Scan all four skill locations with precedence rules 5. Validate skills using Agent Skills CLI 6. Generate `.cursor/rules/skills.mdc` with embedded XML 7. Clean up old marker-delimited sections from `AGENTS.md` ## Requirements - Python 3.8+ - uv (auto-installed when running as script) - Git (auto-installed if missing) When run as a Python script, it auto-installs uv, then installs itself as a uv tool. Git is auto-installed if missing using the appropriate method for your platform. ## Troubleshooting **Skills not appearing:** Verify SKILL.md exists in immediate child directory with valid frontmatter: ```yaml --- name: my-skill description: What this skill does and when to use it --- ```
Related Skills
task-master
AI-powered task management for structured, specification-driven development. Use this skill when you need to manage complex projects with PRDs, break down tasks into subtasks, track dependencies, and maintain organized development workflows across features and branches.
task-master-viewer
Launch a Streamlit GUI for Task Master tasks.json editing. Use when users want a visual interface instead of CLI/MCP commands.
task-master-install
Install and initialize task-master for AI-powered task management and specification-driven development. Use this skill when users ask you to parse a new PRD, when starting a new project that needs structured task management, when users mention wanting task breakdown or project planning, or when implementing specification-driven development workflows.
streamlit-development
Developing, testing, and deploying Streamlit data applications on Snowflake. Use this skill when you're building interactive data apps, setting up local development environments, testing with pytest or Playwright, or deploying apps to Snowflake using Streamlit in Snowflake.
snowflake-connections
Configuring Snowflake connections using connections.toml (for Snowflake CLI, Streamlit, Snowpark) or profiles.yml (for dbt) with multiple authentication methods (SSO, key pair, username/password, OAuth), managing multiple environments, and overriding settings with environment variables. Use this skill when setting up Snowflake CLI, Streamlit apps, dbt, or any tool requiring Snowflake authentication and connection management.
snowflake-cli
Executing SQL, managing Snowflake objects, deploying applications, and orchestrating data pipelines using the Snowflake CLI (snow) command. Use this skill when you need to run SQL scripts, deploy Streamlit apps, execute Snowpark procedures, manage stages, automate Snowflake operations from CI/CD pipelines, or work with variables and templating.
schemachange
Deploying and managing Snowflake database objects using version control with schemachange. Use this skill when you need to manage database migrations for objects not handled by dbt, implement CI/CD pipelines for schema changes, or coordinate deployments across multiple environments.
playwright-mcp
Browser testing, web scraping, and UI validation using Playwright MCP. Use this skill when you need to test Streamlit apps, validate web interfaces, test responsive design, check accessibility, or automate browser interactions through MCP tools.
doc-scraper
Generic web scraper for extracting and organizing Snowflake documentation with intelligent caching and configurable spider depth. Scrapes any section of docs.snowflake.com controlled by --base-path.
devcontainer-setup
Create Universal DevContainers optimized for AI agentic workflows with Claude Code, Snowflake CLI, Cortex Code, and dbt. Use when setting up development containers, configuring devcontainer.json, scaffolding AI-ready environments, or when the user mentions devcontainers, containerized development, or Docker development environments.
dbt-testing
dbt testing strategies using dbt_constraints for database-level enforcement, generic tests, and singular tests. Use this skill when implementing data quality checks, adding primary/foreign key constraints, creating custom tests, or establishing comprehensive testing frameworks across bronze/silver/gold layers.
dbt-projects-snowflake-setup
Step-by-step setup guide for dbt Projects on Snowflake including prerequisites, external access integration, Git API integration, event table configuration, and automated scheduling. Use this skill when setting up dbt Projects on Snowflake for the first time or troubleshooting setup issues.