custom-skills-upstream-sync

Analyze upstream repositories and generate YAML and Markdown reports.

5|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ValorVie/custom-skills --skill custom-skills-upstream-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: custom-skills-upstream-sync
Source: https://github.com/ValorVie/custom-skills/tree/main/skills/custom-skills-upstream-sync
Command: npx skills add https://github.com/ValorVie/custom-skills --skill custom-skills-upstream-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Upstream Sync analyzes upstream repositories to surface changes and generate structured reports for review and integration planning.

Core Features & Use Cases

  • Analyze registered upstream repositories to identify updates and potential overlaps.
  • Generate structured YAML/Markdown reports to guide integration decisions.
  • Assess new local repositories for inclusion and upstream compatibility.

Quick Start

Run the analyze_upstream.py script to generate a structured upstream report.

Frequently Asked Questions about custom-skills-upstream-sync

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

FAQPage Schema
How do I generate a diff report for an upstream git repository?

To generate a diff report for an upstream git repository, run the analyze_upstream.py script to parse git histories, categorize file changes, and output structured YAML and Markdown reports for review.

What is upstream sync analysis and when do I need it?

Upstream sync analysis identifies updates and potential overlaps in upstream repositories. You need it to surface changes and generate structured reports for review and integration planning.

Can I analyze local repositories for upstream compatibility?

Yes, you can assess new local repositories for inclusion and upstream compatibility. The automation applies to both registered upstreams and new local repos to generate review-ready diff reports.

Do I need any dependencies to run the upstream sync scripts?

Yes, you need the yaml dependency to run the upstream sync scripts. The Python scripts use it to output structured reports in YAML and Markdown formats for integration planning.

What is the best way to plan integration for upstream changes?

The best way to plan integration for upstream changes is to generate structured YAML and Markdown reports. These reports categorize file changes and guide integration decisions based on parsed git histories.