zeikar/hyperclaude / skills/hyper-setup
hyper-setup
UnverifiedDiagnose hyperclaude prerequisites and report fixes
hyper-setup
Run the doctor probe. Parse the JSON it emits and report per-check status plus the overall verdict.
Prerequisite probe: !node "${CLAUDE_PLUGIN_ROOT}/scripts/setup-doctor.mjs"
What it checks
The probe emits one JSON line: { ok, checks: [{name, detected, required, status, severity, remediation}] }.
The five checks:
- Node.js >= 18 — severity: hard. hyperclaude's bridge is stdlib Node; versions below 18 are unsupported.
- codex-cli >= 0.130.0 on PATH — severity: hard. Version-floor check only (no capability probe). The bridge spawns
codex exec; the tool must be present and at a known-good version. - git on PATH — severity: hard. The bridge reads git state for slug generation and diff targets.
codex --searchglobal flag (pre-subcommand) — severity: hard. The bridge passes--searchas a global flag before the subcommand on every Codex spawn; codex-cli must acceptcodex --search exec --help(exit 0).- Claude Code >= 2.1.232 — severity: conditional. 2.1.232 is the known-good floor for the background-agent transport
hyper-plan-loop,hyper-implement-loop,hyper-docs-loop, andhyper-auto(which chains hyper-plan-loop → hyper-implement-loop) use to reach their agent. Surfaced, not gated: a below-floor or unknown version (claudeoff PATH, unparseable output) is a WARN that never flips the verdict and blocks nothing — the full research→plan→implement flow works regardless.
Reporting directive
The inline probe above runs automatically; parse the single JSON line it emitted to stdout (do not run it again).
The JSON's shape picks the report. A checks[] array — including the normal ok:false "prerequisites failing" case — gets steps 1–3. Only a probe that itself failed (no parseable JSON, or an {ok:false,error:...} object with no checks[]) gets the step 4 fallback.
For the checks[] path:
-
Present a per-check table with columns: Check, Detected, Required, Status. One row per entry in
checks[]. -
For every check where
statusis notPASS, print the check'sremediationfield verbatim on its own line, prefixed withFix:. -
Conclude with an overall verdict line:
- If
okistrue(no hard FAIL):All hard prerequisites met. - If
okisfalse(one or more hard FAILs):N hard prerequisite(s) failing — hyperclaude will not work until fixed.(N = count ofchecks[]entries withseverity:"hard"andstatus:"FAIL"). - The Claude Code version WARN must never flip the overall verdict to fail.
- If
-
Error fallback — print exactly this, and nothing that reads as a pass:
Prerequisite probe could not complete: <error or "no parseable output">. hyperclaude prerequisites are UNKNOWN — re-run /hyperclaude:hyper-setup or run the doctor script directly.
Anti-patterns
- Do NOT spawn Codex, the bridge (
codex-bridge.mjs), or any agent. This skill only runs the doctor probe. - Do NOT auto-install missing tools or modify env variables. This skill is read-only; report-and-advise only.
- The
Bash(node:*)filter permits arbitrary node scripts, so never edit this skill to invoke anything beyond the doctor probe — read-only is prompt-enforced, not tool-enforced. - Do NOT treat the Claude Code version WARN as a hard failure.
- No npm dependencies.
- No manifest entry needed — Claude Code auto-discovers
skills/*/SKILL.md.disable-model-invocation: truekeeps this skill explicit-invoke-only (/hyperclaude:hyper-setup); it is never auto-triggered by its description. - Do not widen
allowed-toolsbeyondBash(node:*), Read.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |