upgrade-setup

Diff existing onboarding setups against latest plugin templates and apply confirmed updates.

5|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/a2ngerer/claude_onboarding_agent --skill upgrade-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade-setup
Source: https://github.com/a2ngerer/claude_onboarding_agent/tree/main/skills/upgrade-setup
Command: npx skills add https://github.com/a2ngerer/claude_onboarding_agent --skill upgrade-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reapplies current onboarding-plugin best practices to an existing onboarding-agent setup, updating templates while preserving user customizations.

Core Features & Use Cases

  • Selective refresh against the latest plugin templates without overwriting user edits.
  • Per-change confirmation with unified diffs and built-in backups.
  • Safe-by-default: only plugin-managed sections are modified; user-owned content remains untouched.
  • Use Case: You want to bring an older project setup up to date without losing your custom tweaks.

Quick Start

Run /upgrade-setup to begin refreshing your onboarding state against the latest templates and review the proposed changes before applying.

Frequently Asked Questions about upgrade-setup

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

FAQPage Schema
How do I refresh onboarding templates without overwriting custom project edits?

To refresh onboarding templates safely, you can diff against the latest plugin templates and prompt for per-section confirmation before applying changes. This updates your setup while preserving all user customizations untouched.

What is the safest way to upgrade an existing onboarding setup?

The safest way to upgrade an onboarding setup is by backing up all touched files and restricting modifications to plugin-managed delimited sections only. User-owned content remains completely untouched during the template refresh process.

How do I update plugin templates while keeping my custom configurations intact?

You can update plugin templates by computing per-section diffs against the latest versions and prompting for confirmation before applying changes. This selective refresh ensures your custom configurations are preserved without overwriting user edits.

Can I review template diffs before applying onboarding updates?

Yes, you can review template diffs before applying onboarding updates because the process computes per-section changes and prompts for confirmation. Unified diffs are displayed so you can evaluate proposed changes before they are applied.

How does the setup identify which sections to update during an onboarding refresh?

The setup identifies sections to update by reading onboarding-meta.json or CLAUDE.md markers to detect the current configuration. It then restricts changes to plugin-managed delimited sections only, ensuring user-owned content remains untouched.

Are my project files backed up before applying template upgrades?

Yes, your project files are backed up before applying template upgrades because the safe-by-default operation creates backups of all touched files. This ensures you can recover your previous setup if needed after the refresh.