From triflux
Runs initial setup and diagnostics for the triflux toolchain: syncs config files, registers HUD statusLine in Claude settings, and executes CLI doctor checks. Supports a `doctor` subcommand for diagnostics only.
How this skill is triggered — by the user, by Claude, or both
Slash command
/triflux:skills-tfx-workspace-skill-snapshot-tfx-setup [doctor][doctor]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
/tfx-setup
/tfx-setup doctor ← 진단만 실행
/tfx-setup)triflux setup 실행settings.json에 statusLine 자동 등록triflux doctor 실행/tfx-setup doctor)triflux doctor만 실행하고 결과를 보고합니다.
Bash("triflux setup")
~/.claude/settings.json을 읽어 statusLine 설정을 확인합니다.
statusLine이 없거나 hud-qos-status.mjs를 가리키지 않는 경우:
// settings.json에 추가할 statusLine 설정
{
"statusLine": {
"type": "command",
"command": "\"<NODE_PATH>\" \"<HOME>/.claude/hud/hud-qos-status.mjs\""
}
}
<NODE_PATH>: node -e "console.log(process.execPath)" 결과<HOME>: ~ 또는 홈 디렉토리 절대 경로Read 도구로 ~/.claude/settings.json을 읽고, Edit 도구로 statusLine을 추가/수정합니다.
Bash("triflux doctor")
## tfx-setup 완료
| 항목 | 상태 |
|------|------|
| tfx-route.sh | ✅ v2.0 |
| HUD (hud-qos-status.mjs) | ✅ v1.7 |
| HUD 설정 (settings.json) | ✅ statusLine 등록됨 |
| Codex CLI | ✅ / ⚠️ 미설치 (선택) |
| Antigravity CLI | ✅ / ⚠️ 미설치 (선택) |
| 스킬 | ✅ N개 설치됨 |
### 다음 단계
- Codex 미설치 시: `npm install -g @openai/codex`
- Antigravity 미설치 시: Google Antigravity 설치 후 `agy`가 PATH에서 실행되는지 확인
- 세션 재시작하면 HUD가 표시됩니다
| 상황 | 처리 |
|---|---|
triflux: command not found | npm install -g triflux 안내 |
settings.json 파싱 실패 | 백업 생성 후 새로 작성 |
| 기존 statusLine이 다른 HUD | 사용자에게 덮어쓸지 확인 |
| node.exe 경로에 공백 | 큰따옴표로 감싸기 |
문제 발생 시 /tfx-doctor 실행. (--fix 자동 수정, --reset 캐시 초기화)
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub tellang/triflux