fix-powerpacks

Diagnose and repair Powerpacks install paths and local state directories.

1|1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/powerset-co/powerpacks --skill fix-powerpacks-powerset-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fix-powerpacks
Source: https://github.com/powerset-co/powerpacks/tree/main/packs/powerset/skills/fix-powerpacks
Command: npx skills add https://github.com/powerset-co/powerpacks --skill fix-powerpacks-powerset-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Powerpacks installs can end up running from the wrong path (such as a legacy .codex/powerpacks checkout), leaving local state split across duplicate .powerpacks roots, broken msgvault/WhatsApp/LinkedIn links, and stale run-id artifact directories. This Skill diagnoses those path and state problems and applies safe, non-destructive repairs. ## Core Features & Use Cases - Canonical repo enforcement: Resolves the non-.codex Powerpacks repo and refuses to run product commands from legacy installs. - State adoption and repair: Copies newer or missing managed files (.env, contacts CSVs, wacli stores, network-import manifests) into the canonical .powerpacks root without overwriting newer data. - Health reporting: Reports discovery/import manifest status per source (Gmail, LinkedIn, Messages), wacli authentication state, and stale run-id/temp directories for later cleanup. - Use Case: After Codex accidentally used .codex/powerpacks and setup became brittle, run the fixer to adopt the newer state into the canonical repo, scrub a bad unauthenticated wacli placeholder, and get a manifest health report. ## Quick Start Ask the agent to run $fix-powerpacks to diagnose my Powerpacks install paths and repair the local state directories.

Frequently Asked Questions about fix-powerpacks

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

FAQPage Schema
How do I fix Powerpacks running from the wrong install path?▼

Run the fix-powerpacks workflow, which resolves the canonical non-.codex repo, then executes scripts/fix-powerpacks-state.py to adopt newer state from legacy installs. It copies only missing or newer managed files and never runs product commands from ~/.codex/powerpacks.

How do I move .powerpacks state out of .codex safely?▼

The fixer copies newer or missing managed files from .codex/powerpacks/.powerpacks into the canonical repo's .powerpacks directory. Legacy directories are quarantined rather than deleted, and only after your explicit approval via the --quarantine-legacy-state flag.

Does the fixer overwrite my existing .env or credentials?▼

No. The legacy .env is copied only when the canonical .env is missing, and its contents are never printed. Existing canonical files are kept whenever they are newer than the legacy copies.

Can the fixer run imports, syncs, or cleanup automatically?▼

No. Imports, msgvault sync, WhatsApp sync, enrichment, uploads, and destructive cleanup all require separate explicit user requests. The default run applies only safe local repairs and read-only status checks.

Why does the fixer report stale run-id directories instead of deleting them?▼

Stale run-id and temp artifact directories under .powerpacks/network-import are cleanup candidates, not part of the stable path contract. The fixer reports their path, size, and count so you can decide whether to quarantine or remove them later.