skills.rest
tellang
tellangCOMMUNITY
Explore all skills by this author →
GitHub

tfx-doctor

Diagnose and repair triflux environment issues, including CLI detection, HUD display, and cache errors.

7|2|Updated Mar 18, 2026
Search Tags:#troubleshooting#cli#cache#diagnostics#repair#hud#triflux
One-click install
npx skills add https://github.com/tellang/triflux --skill tfx-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tfx-doctor
Source: https://github.com/tellang/triflux/tree/main/skills/tfx-doctor
Command: npx skills add https://github.com/tellang/triflux --skill tfx-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill diagnoses and automatically resolves common issues with the triflux environment, such as CLI detection problems, HUD display errors, cache corruption, and missing skill installations.

Core Features & Use Cases

  • Comprehensive Diagnostics: Checks for triflux CLI, HUD, Codex/Gemini CLI paths, skill installations, plugin registrations, MCP cache, and more.
  • Automated Repair: Attempts to fix detected issues by resynchronizing files, cleaning corrupted cache, and resetting configurations.
  • Cache Management: Provides options to reset specific caches or perform a full triflux cache cleanup.
  • Use Case: If your triflux HUD is not appearing or commands like tfx-route.sh are not recognized, running /tfx-doctor --fix can automatically resolve these problems.

Quick Start

Run /tfx-doctor --fix to diagnose and automatically repair triflux issues.

Frequently Asked Questions about tfx-doctor

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

FAQPage Schema
How do I fix triflux CLI commands not recognized errors?▼

To fix triflux CLI commands not recognized errors, run /tfx-doctor --fix to automatically check script installations, verify CLI paths, and resynchronize missing files to restore functionality.

Why is my triflux HUD not displaying and how to repair it?▼

Your triflux HUD is not displaying due to misconfigured HUD settings or missing script files. Running the triflux diagnostic tool checks HUD configurations, detects display errors, and attempts automated repair by resetting the affected display configurations.

Does triflux cache corruption cause skill installation failures?▼

Yes, triflux cache corruption directly causes skill installation failures and plugin registration errors. The diagnostic tool resolves this by identifying corrupted MCP cache files and automatically clearing them to restore proper skill installation workflows.

What is the best way to run comprehensive triflux environment diagnostics?▼

The best way to run comprehensive triflux environment diagnostics is to execute /tfx-doctor --fix. This checks CLI detection, HUD configurations, Codex and Gemini CLI paths, skill installations, plugin registrations, and MCP cache status in one pass.

Can I clear specific corrupted caches without a full triflux reset?▼

Yes, you can clear specific corrupted caches without a full triflux reset. The diagnostic tool provides targeted cache management options, allowing you to reset individual corrupted cache files or perform a complete cache cleanup as needed.

Related Skills

Explore More Software Engineering Skills→
silversteinsilverstein
1.4k

minutes-verify

Verify Minutes CLI, whisper models, directories, audio input, and PID state.

Community
Intermediate
tellangtellang
7

tfx-setup

Automate triflux setup, HUD configuration, and CLI diagnostics.

Community
Basic
taloncjonestaloncjones

dotfiles-diagnostics-and-tooling

Interprets dotfiles diagnostic outputs to validate git/SSH/Claude identity, plugin installation, settings.json, symlinks, and cloud session health.

Community
Advanced
ManuelKugelmannManuelKugelmann
3

check-bash

Validate Bash script syntax without executing the scripts.

Community
Basic