Agent skill

Kraken Shared

by krakenfx in krakenfx/kraken-cli

Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.

MITAuto-check passedBusiness, Finance & HR

Install Kraken Shared

skills CLI
$ npx skills add krakenfx/kraken-cli --skill kraken-shared -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install krakenfx/kraken-cli kraken-shared --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/krakenfx/kraken-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kraken-shared .claude/skills/kraken-shared && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kraken-shared
GitHub stars
750
Token cost
~849 tokens
SKILL.md length
386 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.

  • Business, Finance & HR work in your project
  • SKILL.md covers Invocation Contract, Authentication, Error Routing and Safety
  • Needs KRAKEN_API_KEY and KRAKEN_API_SECRET

What it does

Kraken Shared is an agent skill from krakenfx/kraken-cli. Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR. The repository describes itself as: The first AI-native CLI for trading crypto, stocks, forex, and derivatives. The licence is MIT.

When your agent uses it

  • Business, Finance & HR work in your project

Example prompts

  • “/kraken-shared”

Requirements

  • A credential in KRAKEN_API_KEY
  • A credential in KRAKEN_API_SECRET

What it can do on your machine

Read from SKILL.md and the folder at commit aa56e59. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KRAKEN_API_KEY
    • KRAKEN_API_SECRET
    • KRAKEN_FUTURES_API_KEY
    • KRAKEN_FUTURES_API_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kraken Shared loads about 849 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 386 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~849

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from krakenfx/kraken-cli at commit aa56e59, republished under its MIT licence (© krakenfx). 386 words, ~849 tokens.

Download SKILL.mdSave it as .claude/skills/kraken-shared/SKILL.md (or your agent's skills folder).
name
kraken-shared
description
Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.
version
1.0.0

kraken-shared

This tool is experimental. Commands execute real financial transactions on the Kraken exchange. Test with kraken paper before using real funds. See DISCLAIMER.md for full terms.

Invocation Contract

Always call:

bash
kraken <command> [args...] -o json 2>/dev/null

Rules:

  • Parse stdout only.
  • Treat stderr as diagnostics.
  • Exit code 0 means success.
  • Non-zero exit means failure with JSON envelope in stdout.
  • Streaming commands (session start, record, ws, streamd) emit JSONL: match lines by their "type" field (e.g. scan for "type":"session_started" to get the session handle) — never assume a line position, because live market frames interleave on stdout.
  • Probe capability, not version, at the start of a loop: kraken session --help >/dev/null 2>&1 exits 0 on a build that speaks this contract and 2 on an older one — kraken --version cannot tell them apart across a vocabulary change.
  • Market-data field names are readable (last_price, not c[0]). Only ticker still keys on Kraken's INTERNAL pair name (XXBTZUSD, not BTCUSD) — reach its fields with .[] or to_entries, never a hardcoded key. ohlc/trades/spreads reshape to {pair, …}: fold the named row array (.candles/.trades/.spreads) directly, never the whole object — ohlc keeps a sibling last cursor that poisons naive iteration. orderbook drops the wrapper to top-level .asks/.bids.
  • Validate every number a READ produces before it gates an order or lands in a reason. On an empty or failed read, record kraken session note --kind alert --reason "READ failed: ..." and end the step — never interpolate a failed read into a reason, or the decision log fills with plausible-looking false evidence.
Show full SKILL.md (143 more words)Show less

Authentication

bash
export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"

Optional futures credentials:

bash
export KRAKEN_FUTURES_API_KEY="your-futures-key"
export KRAKEN_FUTURES_API_SECRET="your-futures-secret"

Public market data and paper trading require no credentials.

Error Routing

Route on .error:

  • auth: re-authenticate
  • rate_limit: read suggestion and docs_url fields, adapt strategy
  • network: retry with exponential backoff
  • validation: fix inputs, do not retry unchanged request
  • api: inspect request parameters

Safety

The catalog marks 41 commands as dangerous: true. Always check the dangerous field in agents/tool-catalog.json before executing a command.

Require explicit human approval before:

  • live buy or sell orders (spot and futures)
  • order amendments, edits, and batch operations
  • cancel and cancel-all operations
  • withdrawals and wallet transfers
  • earn allocate/deallocate
  • subaccount transfers
  • WebSocket order mutations

Use paper trading for dry runs:

bash
kraken workspace create sandbox --capital 10000 --mode paper -o json
export KRAKEN_WORKSPACE=sandbox

If you hit a mismatch between what you are trying to do and the CLI's interface or responses — including a mismatch between this skill and the installed CLI version's contract — feel free to submit feedback with kraken feedback.

© krakenfx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/kraken-shared of krakenfx/kraken-cli.

Open the folder on GitHubat commit aa56e59

Compare with similar skills

Kraken Shared next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kraken Shared compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kraken Shared this skillkrakenfx/kraken-cli750—~849Automated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Theme Detectortradermonty/claude-trading-skills3k2 repos~4.9kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7293 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT

Similar skills

  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    321 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed

More from krakenfx/kraken-cli

All 59 skills in this repo
  • Kraken Alert Patterns

    krakenfx/kraken-cli

    Price alerts, threshold monitoring, and notification triggers for agents.

    750 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Autonomy Levels

    krakenfx/kraken-cli

    Progress from manual trading to full agent autonomy with controlled risk at each level.

    750 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Basis Trading

    krakenfx/kraken-cli

    Capture the spot-futures price spread with delta-neutral basis trades.

    750 GitHub stars~802 tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Dca Strategy

    krakenfx/kraken-cli

    Dollar cost averaging with scheduled buys and performance tracking.

    750 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Earn Staking

    krakenfx/kraken-cli

    Discover staking strategies, allocate funds, and track earn positions.

    750 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Error Recovery

    krakenfx/kraken-cli

    Handle order failures, network errors, and duplicate submissions safely.

    750 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Kraken Shared

What does Kraken Shared do?

Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety. Kraken Shared is an agent skill from krakenfx/kraken-cli. Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.

When should I use Kraken Shared?

Kraken Shared fits situations like: business, Finance & HR work in your project.

How do I install Kraken Shared in Claude Code?

Run `npx skills add krakenfx/kraken-cli --skill kraken-shared -a claude-code`. Or copy the skill folder (skills/kraken-shared in krakenfx/kraken-cli) into .claude/skills/kraken-shared in your project. Claude Code loads it when a task matches its description.

How do I install Kraken Shared in Codex?

Run `npx skills add krakenfx/kraken-cli --skill kraken-shared -a codex`. Or copy the skill folder (skills/kraken-shared in krakenfx/kraken-cli) into .agents/skills/kraken-shared in your project. Codex loads it when a task matches its description.

Can I use Kraken Shared in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add krakenfx/kraken-cli --skill kraken-shared -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kraken-shared, .gemini/skills/kraken-shared, .github/skills/kraken-shared and .opencode/skills/kraken-shared in your project.

What does Kraken Shared need to run?

Going by SKILL.md and its folder, Kraken Shared needs credentials named KRAKEN_API_KEY, KRAKEN_API_SECRET, KRAKEN_FUTURES_API_KEY and KRAKEN_FUTURES_API_SECRET. Our summary lists: A credential in KRAKEN_API_KEY; A credential in KRAKEN_API_SECRET.

Does Kraken Shared access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kraken Shared safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kraken Shared use?

Kraken Shared is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kraken Shared use?

About 849 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kraken Shared?

Skills that share tags, products or a category with Kraken Shared: Technical Analyst (tradermonty/claude-trading-skills, 3k stars), Theme Detector (tradermonty/claude-trading-skills, 3k stars), Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars) and Stock API (zhangxiangliang/stock-api, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kraken Shared?

krakenfx (a GitHub organization) maintains it in krakenfx/kraken-cli, which has 750 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on August 7, 2026.

Source: krakenfx/kraken-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.