cmc-cli - SKILL.md Agent Skill

name: cmc-cli description: Use when working with the CoinMarketCap CLI, choosing shipped commands, or answering how to use cmc in scripts, TUI flows, or agent workflows. version: 0.1.0 metadata: requires: bins: - cmc env: - CMC_API_KEY install: | go install github.com/openCMC/CoinMarketCap-CLI@latest mv "$(go env GOPATH)/bin/coinmarketcap-cli" "$(go env GOPATH)/bin/cmc"

CMC CLI

Overview

cmc is the CoinMarketCap-native CLI. Prefer commands that answer a user intent in one pass and keep stdout compact for scripts and agents.

Prerequisites

This skill requires:

cmc CLI installed and available on PATH — see CoinMarketCap CLI for installation options
CMC_API_KEY environment variable set with a valid CoinMarketCap API key
Authentication completed via cmc auth

If either dependency is missing, the skill will not function.

Quick Reference

Need	Use	Notes
Exact asset lookup	`resolve`	Prefer `--id`, `--slug`, or `--symbol` for deterministic identity.
Quote + enrichments	`price`	Use `--with-info` and `--with-chain-stats` when you need more context.
Fuzzy discovery	`search`	Use for name/symbol lookup or DEX address discovery.
Market scan	`markets`, `trending`, `top-gainers-losers`	Use table output when a human is reading.
Time series	`history`	Use `--interval 5m
Global context	`metrics`, `news`, `pairs`	Good bundle commands; avoid splitting into smaller metrics unless necessary.
Live polling	`monitor`	Polling only, not websocket streaming.
Interactive views	`tui`	Human inspection only; not for scripting.

Output Rules

Default output is compact JSON.
Use -o table for readable terminal output.
Use --dry-run to inspect request shape without calling the API.
Keep identity flags explicit when determinism matters.

Slash Command Note

This skill is guidance for using the cmc runtime. It does not create a built-in /cmc slash command by itself.

Hosts may surface it as a skill, reusable workflow, or contextual suggestion.
A /cmc command only exists if the host explicitly adds a slash-command wrapper or alias for this skill.
For hosts such as Claude Code or OpenClaw, do not assume skill registration alone will produce /cmc.

Workflow

Use resolve when the user already knows the asset.
Use search when the user knows a name, symbol, or contract but not the exact identity.
Use price for quotes, then add --with-info or --with-chain-stats only when the bundle is needed.
Use markets, trending, top-gainers-losers, metrics, news, or pairs for broader market context.
Use tui only when a human wants an interactive terminal view.

Common Mistakes

Do not use search as an exact-lookup replacement when resolve is available.
Do not send scripting workloads to tui.
Do not split a bundle into smaller commands unless the user asked for the narrow view.
Do not assume every numeric or token-like string should map to a symbol; prefer the shipped command heuristics.