chief-upgrade

Upgrade Chief installations and display What's New summaries.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/onlypfachi/chief --skill chief-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chief-upgrade
Source: https://github.com/onlypfachi/chief/tree/main/chief-upgrade
Command: npx skills add https://github.com/onlypfachi/chief --skill chief-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Chief to the latest version can be error-prone and time-consuming when different install modes (global, local, vendored) exist. This skill streamlines detection, upgrade, and post-upgrade synchronization while ensuring a safe rollback path.

Core Features & Use Cases

  • Detects install type (global-git, local-git, vendored, vendored-global) and locates the correct install directory.
  • Automates upgrade flow with optional auto-upgrade, interactive prompts, and backup/restore in case of failure.
  • Syncs local vendored copies after a successful upgrade and prints a concise "What's New" summary.

Quick Start

Run /chief-upgrade to check for updates, upgrade when available, and view the What's New summary.

Frequently Asked Questions about chief-upgrade

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

FAQPage Schema
How do I upgrade Chief to the latest version across different install types?

To upgrade Chief to the latest version, run /chief-upgrade to automatically detect your install type (global-git, local-git, or vendored), apply the upgrade, and display a What's New summary. It supports auto-upgrade, interactive prompts, and safe rollback for a seamless flow.

What is the safest way to automate version control updates for a vendored install?

The safest way to automate version control updates for a vendored install is using an upgrade flow with built-in backup and restore capabilities. This ensures that if an upgrade fails, the system automatically rolls back to the previous state and syncs local vendored copies only after success.

Can I rollback a failed upgrade if my local-git installation breaks?

Yes, you can rollback a failed upgrade. The upgrade process includes a safe rollback path that automatically restores your backup if the upgrade fails, ensuring your local-git or global-git installation remains intact and operational during version control updates.

Does the Chief upgrade process work with global, local, and vendored installations?

Yes, the Chief upgrade process works with global-git, local-git, vendored, and vendored-global installations. It detects the specific install type, locates the correct install directory, and applies the appropriate upgrade flow with changelog parsing and post-upgrade synchronization for vendored copies.

How do I view the changelog and what's new after updating my DevOps automation tools?

To view the changelog and what's new after updating, the upgrade process parses the changelog and prints a concise What's New summary upon successful completion. This surfaces the latest changes immediately without requiring you to manually check separate version control logs.

What are the limitations of using automated upgrade scripts for local software installs?

Automated upgrade scripts for local software installs require a YAML frontmatter with a name and description in SKILL.md to function properly. If this structure is missing or the install directory cannot be detected, the reproducible upgrade flow will trigger clear error handling rather than proceeding blindly.