rebase-on-main

Synchronizes local Git feature branches with origin/main via fetch and rebase, managing dirty working trees and conflicts.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/fsolla/teqo --skill rebase-on-main-fsolla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rebase-on-main
Source: https://github.com/fsolla/teqo/tree/main/.cursor/skills/rebase-on-main
Command: npx skills add https://github.com/fsolla/teqo --skill rebase-on-main-fsolla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the complex, error-prone process of synchronizing a feature branch with the latest changes from the main branch, ensuring a clean history without manual intervention.

Core Features & Use Cases

  • Intelligent Sync: Automatically fetches origin/main and rebases the current branch while handling dirty working trees via smart stash or commit decisions.
  • Conflict Resolution: Provides structured guidance for resolving merge conflicts, specifically tailored for Teqo project files like migrations and lockfiles.
  • Use Case: When a developer needs to bring their work up to date with the latest production-ready code before opening a PR, this Skill handles the entire git workflow, including environment detection and conflict management.

Quick Start

Use the rebase-on-main skill to synchronize the current feature branch with the latest origin main and resolve any resulting conflicts.

Frequently Asked Questions about rebase-on-main

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

FAQPage Schema
How do I rebase a feature branch onto origin main safely?

To rebase a feature branch onto origin main safely, this Skill automates git fetch and rebase operations while managing dirty working trees through intelligent stash or commit decisions. It handles the synchronization workflow without manual intervention.

How can I resolve git merge conflicts for database migrations and lockfiles during a rebase?

To resolve git merge conflicts for database migrations and lockfiles during a rebase, this Skill implements specific conflict resolution heuristics tailored for project-specific files. It provides structured guidance to handle these targeted file types.

What happens to uncommitted changes when synchronizing a branch with main?

When synchronizing a branch with main, uncommitted changes in dirty working trees are managed by automatically deciding between stash or commit strategies based on file content and branch state. This ensures local modifications are preserved safely.

Can I use this rebase workflow without any external dependencies?

Yes, you can use this rebase workflow without any external dependencies. The Skill operates independently with no required dependencies, relying solely on standard git version-control commands to synchronize branches.

When should I use an automated git rebase instead of a standard merge to sync branches?

Use an automated git rebase instead of a standard merge to sync branches when you need a clean history without manual intervention. This approach is ideal for bringing work up to date with production-ready code before opening a pull request.