skill-sync

Automate pushing Claude skills to the dwarvesf/claude-skills GitHub repo via MCP.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dwarvesf/claude-skills --skill skill-sync-dwarvesf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/dwarvesf/claude-skills/tree/main/skills/skill-sync
Command: npx skills add https://github.com/dwarvesf/claude-skills --skill skill-sync-dwarvesf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool automates pushing Claude.ai skills to the dwarvesf/claude-skills GitHub repository via the MCP workflow, eliminating manual zip/unzip steps and reducing human error.

Core Features & Use Cases

  • Automatic push: Syncs local skill definitions from Claude.ai to the GitHub repo with conflict detection using version headers.
  • Diff-aware updates: Detects changes in local vs. repo SKILL.md and guides resolution to keep repos in sync.
  • Safe automation: Requires MCP connection and proper prerequisites to ensure secure and auditable deployments.

Quick Start

Tell Claude to "sync skills" to push your local skills to the GitHub repository via MCP.

Frequently Asked Questions about skill-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically sync local Claude skills to a GitHub repository?

To automatically sync local Claude skills to a GitHub repository, use skill-sync to push definitions from /mnt/skills/user/<skill-name>/SKILL.md via MCP. It eliminates manual zip/unzip steps by applying diff checks against the repo to detect conflicts.

How does diff checking work when pushing skill updates to GitHub?

Diff checking compares local SKILL.md files against raw GitHub content using version headers to detect changes. This diff-aware update mechanism identifies conflicts and guides resolution to ensure your local skills and repository stay perfectly synchronized.

Do I need an active MCP connection to push skills to GitHub?

Yes, pushing skills to GitHub requires an active Github MCP Worker connection and access to raw GitHub content for version comparisons. This safe automation prerequisite ensures your skill deployments remain secure and fully auditable.

Can I resolve version conflicts when syncing skills to the dwarvesf repo?

Yes, you can resolve version conflicts when syncing skills to the dwarvesf repo. The tool detects changes between local and repository SKILL.md files using version headers and actively guides you through the conflict resolution process.

What is the best way to automate Claude skill deployment without manual zipping?

The best way to automate Claude skill deployment without manual zipping is using an MCP workflow that directly syncs local files. This approach applies diff checks against the remote repository to safely push updates and reduce human error.

Why are my local skill definitions not syncing with the remote GitHub repository?

Local skill definitions fail to sync with the remote GitHub repository when there is no active MCP connection or proper prerequisites are unmet. Additionally, unresolved diff conflicts between your local SKILL.md and the repo version will block the push.