← ClaudeAtlas

akcli-setuplisted

Verify and repair the akcli environment before (or when) anything misbehaves — run `akcli doctor` to probe Python, the akcli install, packaged schemas, kicad-cli, libngspice, config discovery and (opt-in) jlc network reachability, then apply the per-OS remediation for whatever is missing. Use this skill when: setting up akcli on a new machine or CI runner; a command fails with KICAD_CLI_MISSING, NGSPICE_MISSING, exit 7, "command not found", or import errors; `akcli sim` cannot find an engine; `jlc` cannot reach the network; or the user asks to "check the environment" / "安裝" / "環境檢查" / "設定 akcli". Triggers on keywords: setup, install, doctor, environment, kicad not found, ngspice missing, KICAD_CLI, AKCLI_NGSPICE, PATH, pipx, PEP 668.
tipoLi5890/akcli · ★ 4 · AI & Automation · score 74
Install: claude install-skill tipoLi5890/akcli
# akcli-setup — probe first, then repair exactly what is missing Never guess at an environment problem: `akcli doctor` probes most optional capabilities **the same way the features themselves discover them**, so its verdict matches what the failing command actually saw. (Exception: `pdftotext` — see the table below.) ## (1) Probe ```bash akcli doctor # offline report: python/akcli/schemas/kicad-cli/ngspice/config akcli doctor --network # also probe the jlc endpoint (only networked check) akcli doctor --json # machine-readable: {checks: {name: {ok, detail, hint}}, ok} ``` Every `MISSING` row prints its own remediation hint. Only **python** is a hard requirement — kicad-cli / ngspice / network / config are optional capabilities that specific features need: | Capability | Needed by | Without it | |---|---|---| | `kicad-cli` | advisory ERC after `draw --apply`, `view live` SVG, parity tests | everything else works; those degrade gracefully | | `ngspice` (libngspice) | `akcli sim` execution | `sim --deck-only` still emits the SPICE deck | | `network` | the `jlc` family only | all analysis/authoring/sim stays offline | | `pdftotext` (poppler) | `review facts verify` quote checks | verify still runs; quoted facts report `FACTS_QUOTE_UNVERIFIED` (NOTE) instead of a real text match — note: unlike the other rows, `akcli doctor` does not currently probe `pdftotext`; check for the binary manually (e.g. `pdftotext -v`) | | `config` (ak