SY

sync-production

Automates the merge of main to production with conflict pre-checks.

Install

mkdir -p .claude/skills/sync-production && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14682" && unzip -o skill.zip -d .claude/skills/sync-production && rm skill.zip

Installs to .claude/skills/sync-production

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Sync the main branch into production via the GitHub merges API. Pre-checks for merge conflicts and bails out with a clear reason if the merge isn't clean. Use when asked to merge main into production, deploy main to production, or sync production.
247 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • →Fetch `origin/main` and `origin/production` branches
  • →List commits that would be merged
  • →Pre-check for merge conflicts with `git merge-tree`
  • →Create a merge commit on `production` server-side via GitHub API
  • →Report conflicting paths if a merge would conflict

How it works

The skill fetches the latest `main` and `production` branches, then uses `git merge-tree` to pre-check for conflicts. If clean, it calls the GitHub merges API to create the merge commit server-side.

Inputs & outputs

You give it
A request to sync the main branch into production, e.g., "Sync production with main."
You get back
A successful merge of `main` into `production` or a report of merge conflicts with conflicting paths.

When to use sync-production

  • →Deploy main to production
  • →Sync production with main branch
  • →Check merge conflicts for production

About this skill

Sync Production

Follow the Git workflow, production deployment, and secret-safety rules in root AGENTS.md.

  • Inspect current main and production revisions and the complete pending diff. Reuse an open main → production promotion PR, or create one for the requested promotion.
  • Check changed Tinybird datasources and pipes in the pending diff. Use bounded production queries and endpoint calls to verify the required schema in pollinations_enter. Tinybird is deployed separately: missing resources or failed probes block promotion. Follow tinybird-deploy for authorized changes.
  • Compare pending D1 migrations with production migration history. Verify that .github/workflows/deploy-cloudflare-production.yml applies them before the affected Workers deploy, and that old Workers remain compatible during that interval. Record both data checks and any blockers in the promotion PR body.
  • Check the current PR head, required checks, conflicts, and deployment prerequisites. Merge through the PR when authorized and checks pass; resolve or report blockers within that workflow.
  • Follow the resulting GitHub Actions deployments. When path filters do not trigger the required production workflow, dispatch it from production as specified in AGENTS.md.
  • Verify the deployed revision, required bindings, and affected behavior; report any incomplete verification.
  • The production deploy re-pushes unchanged, already-approved secrets; that is not a rotation and needs no new approval. A new or changed value does. Per-Worker secret checks: enter-services skill.

When not to use it

  • →When `production` branch has protection that requires PRs
  • →When the user wants to merge branches other than `main` into `production`
  • →When the user wants to perform a local merge with working tree changes

Prerequisites

`gh` (authenticated, push access to `production`)`jq`

Limitations

  • →Requires `gh` and `jq` to be installed.
  • →Branch protection on `production` that requires PRs will cause the skill to exit.
  • →The skill does not perform local checkouts or working tree changes.

How it compares

This skill performs a server-side merge of `main` to `production` via the GitHub API with pre-conflict checks, avoiding local working tree changes and providing a more automated and controlled deployment process than manual git operations.

Compared to similar skills

sync-production side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
sync-production (this skill)04moReviewIntermediate
github-workflow-automation114moReviewAdvanced
testing-workflow1611moReviewIntermediate
github-actions-templates75moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry