If air-gapped machine, avoid network commands unless explicitly requested
Output a Compat Report with recommended command style
Docker fallback mode
If cardano-cli is not installed locally, use the wrapper script in this skill folder to run cardano-cli inside Docker (the Cardano node container images include the CLI).
chmod +x {baseDir}/scripts/cardano-cli.sh
{baseDir}/scripts/cardano-cli.sh version
Notes:
The wrapper mounts your current directory into the container as /work so files like pparams.json, tx.body, datum.json work normally.
If you have a local node socket, set CARDANO_NODE_SOCKET_PATH before running so query commands work.
Override the image with CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:<tag>.
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>
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: flux-point-studios-cardano-agent-skills-cardano-cli-doctor3description: cardano-cli-doctor4---56# cardano-cli-doctor78## When to use9- Before generating CLI workflows to detect correct command style (era-prefixed vs legacy)10- When debugging CLI flag errors or version mismatches11- When setting up a new environment1213## Operating rules (must follow)14- Never ask for or log secret key contents15- Prefer **read-only** diagnostics (`--help`, `version`, `query tip`)16- If air-gapped machine, avoid network commands unless explicitly requested17- Output a **Compat Report** with recommended command style1819## Docker fallback mode20If `cardano-cli` is not installed locally, use the wrapper script in this skill folder to run **cardano-cli inside Docker** (the Cardano node container images include the CLI).2122```bash23chmod +x {baseDir}/scripts/cardano-cli.sh24{baseDir}/scripts/cardano-cli.sh version25```2627Notes:28- The wrapper mounts your current directory into the container as `/work` so files like `pparams.json`, `tx.body`, `datum.json` work normally.29- If you have a local node socket, set `CARDANO_NODE_SOCKET_PATH` before running so `query` commands work.30- Override the image with `CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:<tag>`.3132## Workflow331) Collect environment facts (auto-injected via context)34 - CLI version35 - Available era-prefixed commands (conway, latest)36 - Legacy flag presence (--babbage-era, etc.)37382) Decide command style39 - `cardano-cli conway --help` works → **era-prefixed supported**40 - `--babbage-era` in help → **legacy flags supported**41 - Both exist → prefer **era-prefixed** (newer)42433) Network sanity (optional, if socket available)44 - `cardano-cli query tip --mainnet` or `--testnet-magic <N>`45 - Detect: missing socket, wrong magic, sync status46474) Produce Compat Report48 ```49 CLI Version: X.Y.Z50 Era-prefixed: ✓ conway, latest51 Legacy flags: ✓ --babbage-era52 Recommended: era-prefixed (cardano-cli conway ...)53 Network: --testnet-magic 1 (preprod)54 ```5556## Examples5758### Example 1: Modern CLI (era-prefixed)59**Input:** User has cardano-cli 10.1.06061**Output:**62```63=== Cardano CLI Compatibility Report ===6465CLI Version: 10.1.0.066Git Rev: abc1236768Supported Commands:69 ✓ cardano-cli conway --help (recommended)70 ✓ cardano-cli latest --help71 ✓ cardano-cli babbage --help7273Recommended Style: ERA-PREFIXED74 cardano-cli conway transaction build ...75 cardano-cli conway query utxo ...7677Network Flags:78 Mainnet: --mainnet79 Preprod: --testnet-magic 180 Preview: --testnet-magic 281```8283### Example 2: Legacy CLI84**Input:** User has cardano-cli 8.x8586**Output:**87```88=== Cardano CLI Compatibility Report ===8990CLI Version: 8.24.0.09192Supported Commands:93 ✗ Era-prefixed not available9495Legacy Flags Detected:96 ✓ --babbage-era97 ✓ --alonzo-era9899Recommended Style: LEGACY FLAGS100 cardano-cli transaction build --babbage-era ...101```102103## Safety / key handling104- Avoid commands that print or touch `.skey` files105- Recommend `chmod 600 *.skey` for real funds106- Prefer offline keygen for mainnet107108## References109- `shared/PRINCIPLES.md` (repo)110- [Cardano CLI documentation](https://github.com/IntersectMBO/cardano-cli)111112---113> Converted and distributed by [TomeVault](https://tomevault.io/claim/flux-point-studios) — claim your Tome and manage your conversions.114<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/flux-point-studios-cardano-agent-skills-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.
cardano-cli-doctor It is listed under AI & ML on SkillMD.
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.
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.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io