🥋 Sifu — AI Skills Manager

師傅話：「教一次，全部識。」

Sifu is a CLI tool that manages AI coding skills/rules across multiple IDEs and AI tools. Install a skill once, sync everywhere.

The Problem

Modern AI-powered IDEs (Cursor, Windsurf, Claude, etc.) each have their own skills/rules folders. Managing the same skills across multiple tools is painful:

• Symbolic links (npx skills add) don't work reliably across all IDEs
• Manual copying is tedious and error-prone
• No single source of truth — skills drift out of sync

The Solution

Sifu tracks your skills in a lightweight manifest (~/.sifu/manifest.json) and copies them to all your configured IDE targets. No central store, no redundant copies — skills only live where they're needed.

sifu add vercel-labs/agent-skills

     ↓  downloads + copies directly  ↓

~/.cursor/skills/        ← real copies
~/.claude/skills/        ← real copies
~/.windsurf/skills/      ← real copies

~/.sifu/manifest.json    ← tracks what's installed

Quick Start

npm install -g sifu-skills   # or use npx

# Add your IDE skill folders as targets
sifu targets add ~/.cursor/skills
sifu targets add ~/.claude/skills

# Install skills from a GitHub repo (downloads directly, no git/npx needed)
sifu add vercel-labs/agent-skills        # interactive selection
sifu add vercel-labs/agent-skills --all  # install all skills
sifu add google-gemini/gemini-cli        # discover & pick skills
sifu add owner/[email protected]                # specific branch/tag

# Remove a skill everywhere
sifu remove academic-researcher

# Reconcile + distribute across targets
sifu sync

Commands

| Command | Description | | ------------------------- | ------------------------------------------------------------ | | sifu add <source> | Install skills from a GitHub repo (owner/repo) to all targets | | sifu add <source> --all | Install all skills without prompting | | sifu remove <skill> | Remove a skill from all targets | | sifu sync | Reconcile + distribute skills across all targets | | sifu sync --fast-copy | Auto-sync all untracked skills (latest version, no prompts) | | sifu list | List all installed skills | | sifu targets | List all configured target paths | | sifu targets add <path> | Add a new sync target | | sifu targets rm <path> | Remove a sync target (use --delete to also remove files) | | sifu config | Show current configuration |

How It Works

1. sifu add owner/repo downloads the repo tarball directly from GitHub (no git or npx needed)
2. Sifu scans for SKILL.md files to discover skills, and prompts you to select if multiple found
3. Selected skills are copied directly to all configured targets
4. The manifest (~/.sifu/manifest.json) tracks what's installed
5. sifu sync reconciles any drift — fixes symlinks, handles untracked skills, and ensures all targets are consistent
6. Each target gets a real copy (not symlink), ensuring compatibility with all IDEs

Configuration

Config lives at ~/.sifu/config.json:

{
  "targets": ["~/.cursor/skills", "~/.claude/skills"],
  "ignore": [".git", "node_modules", ".DS_Store"]
}

Skills are tracked in ~/.sifu/manifest.json:

{
  "skills": {
    "react-best-practices": {
      "description": "React performance patterns from Vercel",
      "source": "vercel-labs/agent-skills",
      "installedAt": "2026-02-25T10:30:00.000Z"
    }
  }
}

License

MIT