self-update

Automates safe pkdx updates while preserving user data and customizations.

54|111|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/pkdxtools/pkdx --skill self-update-pkdxtools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-update
Source: https://github.com/pkdxtools/pkdx/tree/main/.claude/skills/self-update
Command: npx skills add https://github.com/pkdxtools/pkdx --skill self-update-pkdxtools

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill updates pkdx to the latest version safely, preserving user data and configurations while upgrading the CLI and skill set.

Core Features & Use Cases

  • Fork and clone workflows: supports both forked repos and direct clones, with guidance for syncing changes.
  • Stash, merge, and conflict handling: safe stash/pull/merge with user-guided resolution for conflicting files.
  • Binary updates & migrations: can fetch or build latest binaries, run migrations, and auto-convert metadata when upstream changes demand it.
  • End-to-end process: ensures a reproducible, auditable update path from Phase 0 to Phase 4 completion.

Quick Start

Run the self-update skill to safely fetch and merge the latest changes into your local pkdx installation.

Frequently Asked Questions about self-update

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

FAQPage Schema
How do I update pkdx to the latest version without losing my custom configurations?

To update pkdx without losing data, the self-update skill automates safe stash, pull, and merge operations while preserving your local configurations. It guides you through conflict resolution to ensure customizations remain intact during the version control process.

What is the safest git workflow for migrating a forked pkdx repository?

The safest git workflow for migrating a forked pkdx repository involves syncing changes from upstream while protecting local data. The process uses stash operations and user-guided conflict resolution to merge updates without overwriting customizations.

How do I resolve merge conflicts when pulling upstream changes to a local clone?

To resolve merge conflicts when pulling upstream changes, the update process halts and provides user-guided resolution for conflicting files. This ensures you manually verify and retain necessary local modifications before completing the git merge.

Can I run binary updates and data migrations at the same time?

Yes, you can run binary updates and data migrations simultaneously. The update process fetches or builds the latest binaries and then executes metadata migrations to ensure your local installation stays fully synchronized with the upstream repository.

Does the pkdx update process work with direct clones or only forks?

The pkdx update process works with both direct clones and forked repositories. It provides specific guidance for syncing local changes in fork-based workflows and handles standard upstream pulls for direct clone installations.

What limitations should I expect during an automated version control update?

During an automated version control update, you must manually handle merge conflicts when local customizations collide with upstream changes. The process pauses to require user-guided resolution for conflicting files before it can safely resume the migration.