update-xt

Reconcile xtrm project installations against canonical package state.

4|1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/xtrm-dev/specialists --skill update-xt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-xt
Source: https://github.com/xtrm-dev/specialists/tree/main/.xtrm/skills/default/update-xt
Command: npx skills add https://github.com/xtrm-dev/specialists --skill update-xt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill repairs xtrm-initialized projects when their install state drifts from the canonical layout, such as stale skill symlinks, broken hook wiring, outdated Pi settings, or missing beads bootstrap files.

Core Features & Use Cases

  • Install Drift Detection: Checks the current project against the expected xtrm installation state and reports what is current versus stale.
  • Targeted Remediation: Rebuilds skills wiring, refreshes hook configuration, restores registry-managed assets, and applies maintenance fixes without unnecessary disruption.
  • Verification and Safety: Confirms implementation-level behavior such as hash-based drift detection and default preservation of local edits before declaring success.
  • Use Case: Use this Skill after upgrading xtrm-tools, when skills stop loading, when hooks are not firing, or when a repo needs to be re-synced to the canonical install state.

Quick Start

Ask me to audit this xtrm project and repair any install drift so its skills, hooks, settings, and registry-managed files match the current canonical state.

Frequently Asked Questions about update-xt

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

FAQPage Schema
How do I fix broken symlinks and hooks after upgrading xtrm-tools?

To fix broken symlinks and hooks after upgrading, you need to reconcile your project against the canonical xtrm state. This process repairs stale skill wiring, refreshes hook configuration, and restores missing beads bootstrap files safely.

What is installation drift detection in xtrm project configuration?

Installation drift detection is a verification mechanism that checks your current xtrm project against the expected canonical package state using hashes. It identifies stale skills wiring, broken hooks, outdated Pi settings, or drifted registry-managed assets.

Does xtrm configuration sync preserve my local changes when repairing install drift?

Yes, xtrm configuration sync preserves your local changes by default when repairing install drift. The remediation process verifies hash-based drift detection and restores canonical symlink, hook, and configuration layouts without unnecessary disruption.

How do I restore registry-managed assets and Pi settings to their canonical state?

To restore registry-managed assets and Pi settings to their canonical state, audit your xtrm project and apply targeted remediation. This rebuilds skills wiring and applies maintenance fixes to re-sync the repo to the expected installation layout.

Why are skills not loading and hooks not firing in my xtrm project?

Skills not loading and hooks not firing indicate your xtrm project has drifted from the canonical installation state. Stale skill symlinks or broken hook wiring require a configuration sync to restore the expected layout.

What's the best way to audit an xtrm project for stale skill wiring?

The best way to audit an xtrm project for stale skill wiring is to run a drift detection check against the canonical package state. This reports what is current versus stale and applies safe remediation steps to restore the layout.