update-nanoclaw

Synchronize a customized NanoClaw fork with upstream updates via merge, cherry-pick, or rebase.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill update-nanoclaw-spyqs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-nanoclaw
Source: https://github.com/spyqs/nanoclaw-email-imap/tree/main/.claude/skills/update-nanoclaw
Command: npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill update-nanoclaw-spyqs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you update a customized NanoClaw install to match upstream changes while preserving your local modifications and minimizing token usage.

Core Features & Use Cases

  • Upstream-safe synchronization: Detects upstream remote/branch, previews what will change, and updates using merge, cherry-pick, or rebase.
  • Low-risk rollback: Creates a timestamped backup branch and tag before touching anything, and provides exact reset commands.
  • Conflict-first workflow: Performs a dry-run conflict preview and then opens only conflicted files for targeted conflict-marker resolution.
  • Post-update validation & migration hints: Runs build and tests, checks CHANGELOG.md for [BREAKING] entries, and prompts you to run referenced migration Skills.

Quick Start

Run /update-nanoclaw in Claude Code to preview and apply upstream NanoClaw updates to your fork with safe conflict handling.

Frequently Asked Questions about update-nanoclaw

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

FAQPage Schema
How do I sync a customized git fork with upstream changes without losing local modifications?

To sync a customized fork with upstream without losing local modifications, use a workflow that detects upstream remotes, previews changes, and applies updates via merge, cherry-pick, or rebase. This preserves local changes while bringing in upstream updates.

What is the safest way to handle merge conflicts when pulling upstream updates into a local git fork?

The safest way to handle merge conflicts during an upstream sync is to perform a dry-run conflict detection first, then open only the conflicted files for targeted conflict-marker resolution. Creating a backup branch before executing the sync ensures low-risk rollback.

Do I need to create a backup branch before rebasing my local install onto a new upstream version?

Yes, you need to create a timestamped backup branch and tag before rebasing your local install onto a new upstream version. This provides exact reset commands and a low-risk rollback path if the rebase introduces unexpected issues.

How do I validate a git rebase or merge after syncing upstream changes to prevent breaking my build?

To validate a git rebase or merge after syncing upstream changes, run npm build and test validations immediately after execution. Additionally, check the CHANGELOG.md for [BREAKING] entries and run referenced migration skills to prevent build failures.

Can I selectively cherry-pick specific upstream commits instead of merging the entire upstream branch?

Yes, you can selectively cherry-pick specific upstream commits instead of merging the entire branch. The upstream sync workflow supports selective cherry-picks, allowing you to preview changes and apply only the desired commits to your local fork.

Why does update-nanoclaw perform a preflight safety check before executing an upstream merge?

Update-nanoclaw performs a git-based preflight safety check before executing an upstream merge to assess conflict risk and ensure the working tree is clean. This prevents data loss and identifies potential merge conflicts before they disrupt the update process.