Troubleshooting

Troubleshooting

Run doctor first:

bash ~/.helix/tc-fe-prep/scripts/helix-doctor.sh
HELIX_DOCTOR_FIX=1 bash ~/.helix/tc-fe-prep/scripts/helix-doctor.sh

Expect 6 skills linked per agent folder.

---

Only helix skill listed (missing workflow stubs)

Cause: Install before stub release, or link-skills.sh not re-run.

Fix:

cd ~/.helix/tc-fe-prep && git pull
bash ~/.helix/tc-fe-prep/scripts/link-skills.sh

Reload IDE / new agent session. Verify:

ls ~/.cursor/skills/ | grep workflow

Should show five *-workflow directories.

---

/helix not found (Claude Code)

1. Re-run install or bash ~/.helix/tc-fe-prep/scripts/claude-plugin-sync.sh
2. New Claude Code session
3. Use helix@helix only — not helix@local

---

Skill not triggering (Cursor / Copilot)

1. Confirm stub exists: ls ~/.cursor/skills/tc-fe-prep-workflow/SKILL.md
2. Re-link: bash ~/.helix/tc-fe-prep/scripts/link-skills.sh
3. Invoke by exact name: tc-fe-prep-workflow (stub loads WORKFLOW.md)

---

Auto-update / stale version

HELIX_FORCE_UPDATE=1 HELIX_AUTO_UPDATE_VERBOSE=1 bash ~/.helix/tc-fe-prep/scripts/helix-auto-update.sh

Log: ~/.helix/auto-update.log

---

More

• Installation
• Issues