sync-upstream-skills

Synchronize upstream skills repositories into a local workspace using git subrepo pulls.

6|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/caitengwei/my-skills --skill sync-upstream-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-upstream-skills
Source: https://github.com/caitengwei/my-skills/tree/main/.claude/skills/sync-upstream-skills
Command: npx skills add https://github.com/caitengwei/my-skills --skill sync-upstream-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of getting multiple upstream skills repositories up to date locally while safely merging them with your private customizations.

Core Features & Use Cases

  • Upstream synchronization via git subrepo: Pulls latest changes for superpowers, obsidian-skills, and Humanizer-zh into the appropriate local subdirectories.
  • Local conflict guidance: Provides a clear, step-by-step conflict resolution workflow (identify conflicted files, interpret intent, merge semantically, stage, and commit).
  • Private workflow alignment: Reinforces that updates are pushed only to your private remote and not back to upstream directly.

Quick Start

Tell Claude to run a sync by saying: Synchronize all upstream skills by pulling superpowers, obsidian-skills, and Humanizer-zh using git subrepo pull, then resolve any merge conflicts using the provided conflict workflow.

Frequently Asked Questions about sync-upstream-skills

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

FAQPage Schema
How do I sync upstream skills repositories without overwriting my local private customizations?

To sync upstream skills safely, this Skill uses git subrepo pull to fetch updates from community repositories like superpowers, obsidian-skills, and Humanizer-zh. It detects merge conflicts against your private edits and provides a step-by-step semantic resolution workflow to preserve your customizations while integrating upstream changes.

What is the best way to resolve merge conflicts when pulling community updates via git subrepo?

The best way to resolve merge conflicts during a git subrepo pull is to follow the provided workflow: identify conflicted files, interpret the upstream intent, merge the changes semantically rather than textually, stage the resolved files, and commit them to your private remote only.

How does git subrepo handle deterministic upstream fetching for multiple community skills?

Git subrepo handles deterministic upstream fetching by pulling latest changes from specific remote repositories—such as superpowers, obsidian-skills, and Humanizer-zh—into designated local subdirectories, ensuring a consistent and predictable synchronization process for routine community update ingestion.

Can I push my merged local skills changes back to the upstream community repositories?

No, you cannot push changes back to upstream community repositories. This Skill enforces private-only push practices, ensuring that your local merges and customizations are pushed exclusively to your private remote and never directly back to the original upstream sources.

What should I do if a git subrepo pull fails due to conflicting private edits in my skills workspace?

If a git subrepo pull fails due to conflicting private edits, you should use the explicit conflict detection and semantic resolution guidance provided by the Skill. This involves identifying the conflicting files, interpreting the intent of both upstream and private changes, merging them semantically, staging, and committing the results locally.

Do I need to manually configure git subrepo to synchronize my my-skills workspace?

You need a local my-skills workspace with git subrepo configured to synchronize upstream repositories. The Skill automates the pull process for superpowers, obsidian-skills, and Humanizer-zh into the appropriate subdirectories, but requires the underlying git subrepo tool to be installed in your environment.