setup-companions

Plan, install, update, and uninstall optional graphify, ponytail, and UI UX Pro Max companions from a pinned lock file.

3|Updated May 2, 2026
One-click install
npx skills add https://github.com/JuanTrujilloDev/agent-config-template --skill setup-companions-juantrujillodev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-companions
Source: https://github.com/JuanTrujilloDev/agent-config-template/tree/main/codex/skills/setup-companions
Command: npx skills add https://github.com/JuanTrujilloDev/agent-config-template --skill setup-companions-juantrujillodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing optional companion tools (graphify, ponytail, ui-ux-pro-max) across a coding-agent setup is error-prone: versions drift, installs go unverified, and removals can delete unrelated files. This Skill centralizes the full lifecycle of those companions behind one pinned lock file with mandatory confirmation before every mutation. ## Core Features & Use Cases - Pinned lifecycle management: Plan, doctor, install, update, and uninstall companions using exact versions and SHA-256 hashes from companions.lock.json, never auto-selecting latest releases. - Offline read-only diagnostics: The doctor action probes local executables, plugin registrations, and file hashes to report each tool as missing, healthy, outdated, or unverifiable without changing anything. - Confirmation-gated mutations: Every install, update, or removal shows the exact command and affected paths, then stops for explicit approval; uninstalls preserve unrelated user configuration and neighboring skill directories. - Use Case: After setting up the agent-config-template in Codex, run the doctor action to verify graphify and ponytail are healthy, then install ui-ux-pro-max only when the project has a UI. ## Quick Start Ask the agent to run /setup-companions doctor to check the status of all optional companions before installing anything.

Frequently Asked Questions about setup-companions

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

FAQPage Schema
How do I install graphify and ponytail for Codex?▼

Run /setup-companions install, which reads companions.lock.json and installs graphifyy==0.9.38 via uv, pipx, or pip, plus the ponytail Codex plugin from its marketplace. Each tool requires explicit confirmation immediately before its install command runs.

How do I check if my companion tools are outdated?▼

Run /setup-companions doctor for an offline, read-only health check. It probes local executables, plugin registrations, and SHA-256 hashes, reporting each tool as missing, healthy, outdated, or unverifiable without repairing anything.

Does setup-companions work without the lock file?▼

No. The Skill reads companions.lock.json before doing anything and stops if it is missing or invalid. It will not reconstruct the lock or search for newer releases, since the lock owns the pinned source, version, and hashes.

When should I install ui-ux-pro-max?▼

Install ui-ux-pro-max only for UI projects, either when explicitly requested or when the project has a UI. It installs ui-ux-pro-max-cli@2.15.0 via npm and runs uipro init, placing files under .agents/skills/ui-ux-pro-max/.

Will uninstalling a companion delete my other files?▼

No. Uninstall lists only the named companion-owned package, plugin, or files, then confirms before removal. It preserves unrelated user configuration and never recursively deletes a parent skill directory or neighboring skills.