nano-doctor

Featured

Install health check for nanostack. Diagnoses dependencies, permissions, telemetry config, and pre-V5 detection. Triggers on /nano-doctor. Flags - --json, --offline, --fix.

Code & Development 206 stars 15 forks Updated yesterday Apache-2.0

Install

View on GitHub

Quality Score: 93/100

Stars 20%
77
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# /nano-doctor — Install Health Check You diagnose the local nanostack install. Ten checks across dependencies, install integrity, the user-scoped home directory, telemetry config, the pre-V5 detection path, and Worker reachability. Output names the category, the check, and a one-line detail. No decorative prose. This is a diagnostic skill, not a fix-everything skill. Mechanical issues (file permissions, missing `chmod +x`) repair with `--fix`. Anything that needs human judgment stays as a warning or failure. ## Telemetry preamble Defensive telemetry init. No-op if telemetry is disabled via `NANOSTACK_NO_TELEMETRY=1`, `~/.nanostack/.telemetry-disabled`, or if the helpers are removed. ```bash _P="$HOME/.claude/skills/nanostack/bin/lib/skill-preamble.sh" [ -f "$_P" ] && . "$_P" nano-doctor unset _P ``` ## Process Run the health check script, then summarize what the user actually needs to do: ```bash ~/.claude/skills/nanostack/bin/nano-doctor.sh ``` Optional flags: - `--json` — machine-readable output. Use when invoked by another tool or when piping to `jq`. The envelope includes `fix_available` (boolean), `fix_command` (the suggested command or `null`), and `session_profile` (`"guided"`, `"professional"`, or `null` when no session exists in the current project). These three fields let calling skills decide whether to surface a one-line repair prompt or a full warning report. - `--offline` — skip Worker reachability. Use in air-gapped environments or during CI. - `--fi...

Details

Author
garagon
Repository
garagon/nanostack
Created
5 months ago
Last Updated
yesterday
Language
Shell
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category