# truenorth

truenorth checks crypto markets across technical indicators, derivatives, options, DeFi activity, token unlocks, and liquidation risk.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 253 installs · ★ 33 repo stars
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/truenorth/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/truenorth

## What it does

truenorth gives an agent a multi-angle view of a crypto asset. It can inspect RSI, MACD, Stochastic, Bollinger Bands, support and resistance, price, market cap, supply, and changes over 24h, 7d, and 30d. Derivatives coverage includes open interest, funding rates, long/short ratio, and liquidation heatmaps.

The skill also handles options metrics such as max pain, GEX, IV term structure, risk reversal, and put/call ratio. It can look up crypto news and events, compare DeFi protocols by TVL and fees, track vesting schedules, rank token performance, and calculate a liquidation price for a leveraged position. For a token query, it first resolves the name with `tn ner`, then calls the relevant CLI command with `--json`.

The CLI runs locally and reads from a public REST API without authentication. It needs the Node package `@truenorth-ai/cli@latest` and its `tn` binary. The skill is read-only: it does not trade, access wallets, or transfer funds.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill truenorth -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/truenorth/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/truenorth/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill truenorth -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/truenorth/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill truenorth -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/truenorth/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills truenorth
```

2. **Manually: put the files in place**
- File: `.github/skills/truenorth/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill truenorth -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path truenorth
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/truenorth/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill truenorth -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/truenorth/SKILL.md

## When to use it
- inspect a coin's technical indicators
- check funding rates and open interest
- review options max pain and gamma exposure
- find upcoming token unlocks
- calculate liquidation price for a leveraged position

## Example prompts
- Analyze Bitcoin across technicals, derivatives, and recent crypto events.
- Check BTC options sentiment and max pain.
- Calculate my liquidation risk if I long BTC at 95k.

## Similar
- [tracking-crypto-derivatives](https://affpapa.org/en/nevibecode/skills/tracking-crypto-derivatives.md) — skill · 1 install
- [longbridge-derivatives](https://affpapa.org/en/nevibecode/skills/longbridge-derivatives.md) — skill · 3900 installs
- [aave-v3-liquidation-watcher-teneo](https://affpapa.org/en/nevibecode/skills/aave-v3-liquidation-watcher-teneo.md) — skill · 517 installs
- [option-vol-analysis](https://affpapa.org/en/nevibecode/skills/option-vol-analysis.md) — skill · 2100 installs
- [fno-options-analysis](https://affpapa.org/en/nevibecode/skills/fno-options-analysis.md) — skill · ★ 69 repo stars
- [mcp](https://affpapa.org/en/nevibecode/mcp/bykarantelicom-mcp.md) — MCP server · ★ 2 repo stars

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
