File contents cardano-cli-doctor
When to use
Before generating CLI workflows to detect correct command style (era-prefixed vs legacy)
When debugging CLI flag errors or version mismatches
When setting up a new environment
Operating rules (must follow)
Never ask for or log secret key contents
Prefer read-only diagnostics (--help, version, query tip)
If air-gapped machine, avoid network commands unless explicitly requested
Output a Compat Report with recommended command style
Workflow
Collect environment facts (auto-injected via context)
CLI version
Available era-prefixed commands (conway, latest)
Legacy flag presence (--babbage-era, etc.)
Decide command style
cardano-cli conway --help works → era-prefixed supported --babbage-era in help → legacy flags supported Both exist → prefer era-prefixed (newer)
Network sanity (optional, if socket available)
cardano-cli query tip --mainnet or --testnet-magic <N>Detect: missing socket, wrong magic, sync status
Produce Compat Report
CLI Version: X.Y.Z
Era-prefixed: ✓ conway, latest
Legacy flags: ✓ --babbage-era
Recommended: era-prefixed (cardano-cli conway ...)
Network: --testnet-magic 1 (preprod)
Examples
Example 1: Modern CLI (era-prefixed)
Input: User has cardano-cli 10.1.0
Output:
=== Cardano CLI Compatibility Report ===
CLI Version: 10.1.0.0
Git Rev: abc123
Supported Commands:
✓ cardano-cli conway --help (recommended)
✓ cardano-cli latest --help
✓ cardano-cli babbage --help
Recommended Style: ERA-PREFIXED
cardano-cli conway transaction build ...
cardano-cli conway query utxo ...
Network Flags:
Mainnet: --mainnet
Preprod: --testnet-magic 1
Preview: --testnet-magic 2
Example 2: Legacy CLI
Input: User has cardano-cli 8.x
Output:
=== Cardano CLI Compatibility Report ===
CLI Version: 8.24.0.0
Supported Commands:
✗ Era-prefixed not available
Legacy Flags Detected:
✓ --babbage-era
✓ --alonzo-era
Recommended Style: LEGACY FLAGS
cardano-cli transaction build --babbage-era ...
Safety / key handling
Avoid commands that print or touch .skey files
Recommend chmod 600 *.skey for real funds
Prefer offline keygen for mainnet
References
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1 --- 2 name: andrewwestberg-jormanager-cardano-cli-doctor 3 description: cardano-cli-doctor 4 --- 5 6 # cardano-cli-doctor 7 8 ## When to use 9 - Before generating CLI workflows to detect correct command style (era-prefixed vs legacy) 10 - When debugging CLI flag errors or version mismatches 11 - When setting up a new environment 12 13 ## Operating rules (must follow) 14 - Never ask for or log secret key contents 15 - Prefer **read-only** diagnostics (`--help`, `version`, `query tip`) 16 - If air-gapped machine, avoid network commands unless explicitly requested 17 - Output a **Compat Report** with recommended command style 18 19 ## Workflow 20 1) Collect environment facts (auto-injected via context) 21 - CLI version 22 - Available era-prefixed commands (conway, latest) 23 - Legacy flag presence (--babbage-era, etc.) 24 25 2) Decide command style 26 - `cardano-cli conway --help` works → **era-prefixed supported** 27 - `--babbage-era` in help → **legacy flags supported** 28 - Both exist → prefer **era-prefixed** (newer) 29 30 3) Network sanity (optional, if socket available) 31 - `cardano-cli query tip --mainnet` or `--testnet-magic <N>` 32 - Detect: missing socket, wrong magic, sync status 33 34 4) Produce Compat Report 35 ``` 36 CLI Version: X.Y.Z 37 Era-prefixed: ✓ conway, latest 38 Legacy flags: ✓ --babbage-era 39 Recommended: era-prefixed (cardano-cli conway ...) 40 Network: --testnet-magic 1 (preprod) 41 ``` 42 43 ## Examples 44 45 ### Example 1: Modern CLI (era-prefixed) 46 **Input:** User has cardano-cli 10.1.0 47 48 **Output:** 49 ``` 50 === Cardano CLI Compatibility Report === 51 52 CLI Version: 10.1.0.0 53 Git Rev: abc123 54 55 Supported Commands: 56 ✓ cardano-cli conway --help (recommended) 57 ✓ cardano-cli latest --help 58 ✓ cardano-cli babbage --help 59 60 Recommended Style: ERA-PREFIXED 61 cardano-cli conway transaction build ... 62 cardano-cli conway query utxo ... 63 64 Network Flags: 65 Mainnet: --mainnet 66 Preprod: --testnet-magic 1 67 Preview: --testnet-magic 2 68 ``` 69 70 ### Example 2: Legacy CLI 71 **Input:** User has cardano-cli 8.x 72 73 **Output:** 74 ``` 75 === Cardano CLI Compatibility Report === 76 77 CLI Version: 8.24.0.0 78 79 Supported Commands: 80 ✗ Era-prefixed not available 81 82 Legacy Flags Detected: 83 ✓ --babbage-era 84 ✓ --alonzo-era 85 86 Recommended Style: LEGACY FLAGS 87 cardano-cli transaction build --babbage-era ... 88 ``` 89 90 ## Safety / key handling 91 - Avoid commands that print or touch `.skey` files 92 - Recommend `chmod 600 *.skey` for real funds 93 - Prefer offline keygen for mainnet 94 95 ## References 96 - `shared/PRINCIPLES.md` (repo) 97 - [Cardano CLI documentation](https://github.com/IntersectMBO/cardano-cli) 98 99 --- 100 > Converted and distributed by [TomeVault](https://tomevault.io/claim/andrewwestberg) — claim your Tome and manage your conversions. 101 <!-- tomevault:4.0:skill_md:2026-04-13 -->
commit 6a387712c9
Frequently asked questions How do I install the Andrewwestberg Jormanager Cardano CLI Doctor skill? Run npx skillmds@latest add tomevault-io/andrewwestberg-jormanager-cardano-cli-doctor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Andrewwestberg Jormanager Cardano CLI Doctor skill do? cardano-cli-doctor It is listed under Coding & Dev Tools on SkillMD.
Is Andrewwestberg Jormanager Cardano CLI Doctor safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Andrewwestberg Jormanager Cardano CLI Doctor? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Andrewwestberg Jormanager Cardano CLI Doctor free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Andrewwestberg Jormanager Cardano CLI Doctor? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io