force-push-downstream

Force-push a Git branch and its downstream dependency tree to origin.

1|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/brave-experiments/brave-core-tools --skill force-push-downstream-brave-experiments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: force-push-downstream
Source: https://github.com/brave-experiments/brave-core-tools/tree/main/.claude/skills/force-push-downstream
Command: npx skills add https://github.com/brave-experiments/brave-core-tools --skill force-push-downstream-brave-experiments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of force-pushing a Git branch and all of its dependent downstream branches, preventing manual errors and ensuring consistency across a branch hierarchy.

Core Features & Use Cases

  • Automated Branch Pushing: Force-pushes a specified branch and its entire downstream tree to the remote repository.
  • Safety Checks: Includes checks to skip branches that are already up-to-date with their remote counterparts and uses --force-with-lease for safer force-pushing.
  • Use Case: When you need to update a base branch that multiple other branches depend on, this skill ensures all dependent branches are correctly updated on the remote without manual intervention for each one.

Quick Start

Use the force-push-downstream skill to push the current branch and all downstream branches to origin.

Frequently Asked Questions about force-push-downstream

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

FAQPage Schema
How do I force push a Git branch and all dependent downstream branches at once?

To force push a Git branch and its downstream dependents, this Skill automates detection of the entire branch hierarchy and applies updates to the origin remote in a single operation. It provides a summary of actions taken.

What is the safest way to force push rebased branches to a remote repository?

The safest way to force push rebased branches is using the `--force-with-lease` mechanism. This Skill applies that mechanism automatically across your entire downstream dependency tree to prevent overwriting remote changes unexpectedly.

How do I update multiple diverged Git branches without manually pushing each one?

You can update multiple diverged Git branches by running this Skill to intelligently detect the downstream chain, check for divergence against remote branches, and automatically force-push all necessary updates without manual intervention for each branch.

Does this automated branch pushing skip branches that are already up-to-date with origin?

Yes, automated branch pushing includes safety checks that skip branches already up-to-date with their remote counterparts. It only applies force-pushing mechanisms to new branches and existing diverged branches that require synchronization.

When should I use a downstream dependency tree push instead of a standard Git push?

Use a downstream dependency tree push when you rebase a base branch that multiple other branches depend on. It ensures all dependent branches are correctly updated on the remote simultaneously, preventing manual errors and maintaining hierarchy consistency.

What happens if a downstream branch has diverged from the remote during a force push?

When a downstream branch has diverged from the remote, the Skill detects the divergence and applies safe force-pushing mechanisms using `--force-with-lease` to update the branch. It handles both new branches and existing diverged branches automatically.