sync-skills

Syncs locally installed agent skills with a branch of the agent-forge GitHub repository.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/timi-ty/agent-forge --skill sync-skills-timi-ty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skills
Source: https://github.com/timi-ty/agent-forge/tree/main/skills/sync-skills
Command: npx skills add https://github.com/timi-ty/agent-forge --skill sync-skills-timi-ty

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git.

What problem does it solve? Keeping locally installed AI agent skills in sync with a remote repository is tedious and error-prone: new skills get missed, updated skills drift silently, and removed skills linger. This Skill automates the entire install-and-update flow for both Cursor and Claude Code in one pass. ## Core Features & Use Cases - Full diff-based sync: Clones the target branch once, compares whole skill directories against local installs, and classifies each skill as new, updated, removed, or unchanged. - Dual host support: Detects whether it runs in Cursor or Claude Code and uses the correct global and workspace skill paths for each platform, on Windows, macOS, and Linux. - Safe, confirmed changes: Presents a grouped summary and asks for confirmation before adding, updating, or removing anything, with per-skill confirmation for removals. - Post-install setup: Automatically runs the setup wizard for newly installed skills flagged with setup_required in the catalog. - Use Case: You paste the agent-forge repo URL into your agent chat; the Skill fetches the catalog, diffs it against your installed skills, and installs or updates everything after your approval. ## Quick Start Paste the agent-forge GitHub URL into the chat and ask the agent to install or update the skills from that branch.

Frequently Asked Questions about sync-skills

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

FAQPage Schema
How do I install agent skills from a GitHub repo?

Paste the repository URL into your agent chat and ask to install the skills. The Skill parses the URL for owner, repo, and branch, fetches the catalog.json, and installs all skills after your confirmation.

How do I update installed Cursor or Claude Code skills?

Ask the agent to sync or update skills with the repo URL. It clones the branch, compares each installed skill directory against the remote version using diff, and applies confirmed updates in one flow.

Does skill sync work with both Cursor and Claude Code?

Yes, the Skill detects the host tool from the system prompt or available tools and uses the correct paths: ~/.cursor/skills for Cursor and ~/.claude/commands for Claude Code, with workspace-scope variants for each.

What happens to skills removed from the remote catalog?

Locally installed skills no longer present in the remote catalog are flagged as removed. The Skill asks for separate confirmation per skill before deleting the folder, so nothing is removed without approval.

Why does the sync compare whole directories instead of file lists?

The catalog's files array is documentation that can go stale, so comparing only listed files misses changes. A recursive directory diff catches added, removed, and modified files without extra bookkeeping.