skill-upstream-pr

Fork a GitHub skill repository, run the auto-improvement loop, and draft an upstream PR with metrics.

787|71|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/luongnv89/asm --skill skill-upstream-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-upstream-pr
Source: https://github.com/luongnv89/asm/tree/main/skills/skill-upstream-pr
Command: npx skills add https://github.com/luongnv89/asm --skill skill-upstream-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Contributes and coordinates improvements to open-source skills by automating the workflow to fork, run an improvement loop, gather metrics, and propose a friendly upstream PR.

Core Features & Use Cases

  • Fork & clone: create a fork of the target repository and keep remotes aligned for clean PRs.
  • Automated improvement loop: delegate to skill-auto-improver to run the evaluation and generate an iteration plan.
  • PR drafting with metrics: produce a structured PR body containing before/after scores and category deltas for the upstream maintainer.
  • Preview before push: present changes to the user and require explicit confirmation prior to pushing to GitHub.

Quick Start

Run the skill against a GitHub repository, e.g., skill-upstream-pr github.com/owner/repo to start the upstream PR workflow.

Frequently Asked Questions about skill-upstream-pr

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

FAQPage Schema
How do I automate a GitHub fork and pull request for upstream skill improvements?

To automate a GitHub fork and pull request for upstream skill improvements, this skill clones the target repository, runs an evaluation loop, generates metrics, and drafts a friendly PR body. It previews all changes and requires user confirmation before pushing to the fork.

What is the best way to propose upstream enhancements to an open-source GitHub skill?

The best way to propose upstream enhancements is to run an automated improvement loop that gathers baseline and after metrics. This skill delegates to an auto-improver, calculates category deltas, and structures a friendly PR body for the upstream maintainer.

Can I run the skill improvement loop against any GitHub repository?

Yes, you can run the skill improvement loop against any target GitHub repository containing a SKILL.md file. Simply specify the repository URL, and the skill will fork, clone, locate the skill definition, and execute the evaluation.

How do I track skill evaluation metrics before opening an upstream PR?

To track skill evaluation metrics before opening an upstream PR, this workflow collects baseline and after scores during the automated improvement loop. It then formats these category deltas directly into the generated PR body for maintainer review.

Do I need to manually push changes to my fork when drafting an upstream PR?

No, you do not need to manually push changes to your fork. The skill aligns remotes automatically and handles the push process, but it strictly requires explicit user confirmation after previewing the proposed changes before executing the push.

How does the upstream PR workflow handle repository remotes for clean pull requests?

The upstream PR workflow handles repository remotes by automatically forking the target repository and keeping remotes aligned. This ensures a clean PR workflow directly from the generated fork to the upstream repository.