@ascn-ai/skills

One-command installer for ASCN Claude skills and the ascn-data MCP server.

A skill is a Markdown file (SKILL.md) that teaches Claude when and how to reach for a particular toolbox. This CLI ships a curated set of skills built on top of the ascn-data MCP server — 120 crypto data tools spanning CEX, DEX, on-chain, DeFi, prediction markets, derivatives, signals, and neural web search.

What this CLI does

• Copies one or more SKILL.md files into your skills directory (~/.claude/skills/<skill>/ for user scope, ./.claude/skills/<skill>/ for project scope).
• Writes an ascn-data entry to your MCP client config (Claude Desktop / Cursor / Claude Code) pointing to ASCN's hosted SSE endpoint with your Bearer key.
• Preserves any existing mcpServers entries — it only adds ascn-data.
• Auto-detects all three clients. Pass --client <name> to force one.

Install one skill

npx @ascn-ai/skills add --skill ascn-crypto

The wizard will:

1. Detect Claude Desktop / Cursor / Claude Code config locations.
2. Prompt for your ASCN API key (get one at https://ascn.ai/cabinet).
3. Write the MCP server entry to each detected config.
4. Copy the chosen SKILL.md to ~/.claude/skills/<skill>/.

Restart Claude Desktop / reload Cursor afterward.

Install several skills

npx @ascn-ai/skills add --skill ascn-crypto-trading
npx @ascn-ai/skills add --skill ascn-crypto-derivatives
npx @ascn-ai/skills add --skill ascn-crypto-signals

The API key only needs to be supplied on the first run — subsequent installs reuse whatever's already in the MCP config.

Bundled skills

Run npx @ascn-ai/skills list --available to see this in your terminal.

| Skill | Description | | --- | --- | | ascn-crypto | Umbrella skill — answers anything about crypto markets, tokens, wallets, on-chain activity, DeFi, prediction markets, derivatives, signals. 120 tools. | | ascn-crypto-market | Global crypto overview — BTC dominance, top-cap rankings, gainers/losers, market categories, derivatives meta, DeFi TVL totals. | | ascn-crypto-trading | CEX spot/perp price discovery — order books, OHLCV, single-venue funding rate, OI, long/short. | | ascn-crypto-derivatives | Derivatives macro — OI aggregation, liquidations, funding spread, options OI/skew/PCR, ETF flows, smart positioning. | | ascn-crypto-perpdex | Perpetual DEX trading — Hyperliquid, dYdX v4, GMX v2, Drift v2. On-chain perp funding/OI/orderbooks/candles. | | ascn-crypto-dex | DEX pair analysis, new-launch discovery, memecoin research, pool safety / rug checks. | | ascn-crypto-defi | DeFi fundamentals — TVL, yield pools, DEX volumes, stablecoin caps, protocol fees. | | ascn-crypto-onchain | Wallet inspection, tx history, contract ABI/source, gas oracle, ENS, Solana balances. EVM + Solana. | | ascn-crypto-prediction | Polymarket prediction-market analysis — odds, election tracking, whale-position tracking. | | ascn-crypto-signals | Interpreted trading signals — funding arb, basis arb, smart-money positioning, OI anomalies, liquidation pulse. | | ascn-crypto-research | Crypto news, project deep-dives, token narrative research, weekly recaps. | | ascn-token-research | Workflow — deep dive on a specific token. Structured token brief: fundamentals, price action, DEX liquidity, news. | | ascn-whale-watch | Workflow — investigate a wallet address. Multi-chain profile: identity, balances, recent activity, perp / prediction positions. | | ascn-arb-scanner | Workflow — find tradeable cross-venue arbitrage. Ranked funding-rate & basis arbitrage opportunities with verdicts. | | ascn-rug-check | Workflow — verify a token's safety before buying. RED/YELLOW/GREEN verdict with explicit reasoning. | | ascn-funding-radar | Workflow — single-coin funding-rate read across venues + z-score + recent history. |

For the full machine-readable index, see skills/SKILLS.md inside the published package (it's auto-generated by npm run sync).

Commands

| Command | What it does | | --- | --- | | add --skill <name> | Install a skill and wire up the MCP server. | | list [--available] | Show every bundled skill (default) or only those not yet installed (--available). Also shows MCP client wiring. | | remove --skill <name> | Reverse add for that skill. | | test | Ping the configured endpoint with the saved key. | | help | Print the help text. |

Flags

| Flag | Default | Notes | | --- | --- | --- | | --skill <name> | ascn-crypto | Any bundled skill name. See list above or list --available. | | --client <claude\|cursor\|claude-code\|all> | auto-detected | Force a single client. claude = Claude Desktop. | | --endpoint <url> | https://api.ascn.ai/sse | Override for local dev (http://localhost:8080/sse). | | --api-key <key> | (prompt) | Skip the interactive password prompt. | | --scope <user\|project> | user | Skill install destination. project writes into ./.claude/skills/. | | --available | — | list only: filter to skills you haven't installed yet. | | --yes | false | Auto-confirm overwrites. |

Example workflows

# 1. The defaults — install the umbrella ascn-crypto skill against the hosted endpoint
npx @ascn-ai/skills add --skill ascn-crypto

# 2. Install several narrower skills against Cursor only
npx @ascn-ai/skills add --skill ascn-crypto-trading --client cursor
npx @ascn-ai/skills add --skill ascn-crypto-derivatives --client cursor
npx @ascn-ai/skills add --skill ascn-crypto-signals --client cursor

# 3. Local dev MCP, project-scoped skill, fully non-interactive
npx @ascn-ai/skills add \
  --skill ascn-crypto \
  --endpoint http://localhost:8080/sse \
  --api-key ascn_local_dev \
  --client claude-code \
  --scope project \
  --yes

# 4. Audit
npx @ascn-ai/skills list                                  # all bundled + installed
npx @ascn-ai/skills list --available                      # only un-installed

# 5. Verify the server is reachable + auth works
npx @ascn-ai/skills test

# 6. Remove a skill (also clears the ascn-data MCP entry if no other skills use it)
npx @ascn-ai/skills remove --skill ascn-crypto-trading

Where files go

| Client | Path | | --- | --- | | Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json | | Claude Desktop (Linux) | ~/.config/Claude/claude_desktop_config.json | | Cursor | ~/.cursor/mcp.json | | Claude Code | ./.mcp.json (current project) |

| Scope | Skill path | | --- | --- | | user (default) | ~/.claude/skills/<skill-name>/SKILL.md | | project | ./.claude/skills/<skill-name>/SKILL.md |

Development

# Pull every SKILL.md from ../skills/ into the bundled skills/ dir.
# Runs automatically on `npm pack` / `npm publish` (via prepack), or manually:
npm run sync

# Tests (31 unit + integration tests, no network calls)
npm test

# Inspect what would ship in the npm tarball
npm pack --dry-run

The CLI auto-bundles any new skill dropped into the repo's top-level skills/ directory. Just write SKILL.md and run npm run sync — it gets picked up the next time the package is published.

License

MIT — see LICENSE.