sync-skills

Scan local project trees for SKILL.md files and update the claude-skills repository.

19|3|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/qa-aman/claude-skills --skill sync-skills-qa-aman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skills
Source: https://github.com/qa-aman/claude-skills/tree/main/.claude/skills/sync-skills
Command: npx skills add https://github.com/qa-aman/claude-skills --skill sync-skills-qa-aman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams keep a centralized, up-to-date catalog of Claude Code skills by collecting locally available skills from multiple projects, generalizing them, and adding them to the claude-skills repository.

Core Features & Use Cases

  • Scans project trees to locate .claude/skills/*/SKILL.md and extracts core metadata for the central catalog.
  • Genericizes project-specific content to create shareable, reusable skills for the community.
  • Synchronizes the central repository by updating skills.json and the registry, with prompts for changes when conflicts arise.
  • Use Case: When onboarding a new workspace with several projects, run this skill to populate a unified skill catalog for the team.

Quick Start

Run the sync operation to scan local projects, generate generalized skill entries, and update the claude-skills repository.

Frequently Asked Questions about sync-skills

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

FAQPage Schema
How do I sync local Claude skills into a shared repository?

Syncing local Claude skills involves scanning project directories for .claude/skills/*/SKILL.md files, extracting YAML frontmatter metadata, generalizing project-specific content, and updating the claude-skills repository with human-in-the-loop deduplication.

How does deduplication work when collecting skills from multiple local projects?

Deduplication uses a human-in-the-loop workflow that scans multiple local projects for new or updated skills, prompts for changes when conflicts arise, and ensures only unique or modified skill entries update the central repository registry.

Can I generalize project-specific Claude skills for a shared community catalog?

Yes, you can generalize project-specific skills by reading core logic from local SKILL.md files and transforming specialized content into reusable entries suitable for a centralized community Claude skills repository.

What is needed to scan local project trees for Claude Code skills?

Scanning local project trees requires access to environments with multiple local projects containing .claude/skills directories, where the tool reads YAML frontmatter for metadata and preserves optional scripts, references, and assets.

Does syncing skills update the skills.json registry automatically?

Syncing skills updates the skills.json file and central repository registry, but uses a human-in-the-loop deduplication workflow to prompt for changes when conflicts arise rather than fully automating the overwrite process.

What are the limitations of automated skill synchronization across local projects?

Automated skill synchronization requires human-in-the-loop intervention for deduplication and conflict resolution, meaning it cannot fully automate overwrites and requires manual review to preserve core logic when generalizing project-specific content.