Agent skill

Traderspy Position Check

by sickn33 in sickn33/agentic-awesome-skills

Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side.

MITAuto-check passed

Install Traderspy Position Check

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill traderspy-position-check -a claude-code

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

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills traderspy-position-check --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/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/traderspy-position-check .claude/skills/traderspy-position-check && 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
traderspy-position-check
GitHub stars
47k
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
947 words
Files
2 (incl. references)
Skills in repo
1,394
Repo updated
First seen
Licence
MIT

At a glance

Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side.

  • Works in 3 steps: get_technical_indicators — intervals:… → get_derivatives — up to five coins in… → get_positions — symbol, status: "open",…
  • SKILL.md covers When to Use, Inputs, Calls per position (keep it to… and The math (show it, briefly), plus 5 more sections
  • Reaches mcp.traderspy.app

What it does

Traderspy Position Check is an agent skill from sickn33/agentic-awesome-skills. Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side. Reports only; never tells the user to close or add.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/risk-math.md`).

The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

Example prompts

  • “/traderspy-position-check”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. get_technical_indicators — intervals: ["1h","4h","1d"], `indicators: ["rsi","macd","ema",
  2. get_derivatives — up to five coins in ONE call for all positions at once. Funding is a cost
  3. get_positions — symbol, status: "open", limit: 20. Optional; skip on a tight quota.

What it can do on your machine

Read from SKILL.md and the folder at commit 1e53ce2. 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.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.traderspy.app

    Also links to:

    • traderspy.app

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Traderspy Position Check loads about 1.8k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 947 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

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 sickn33/agentic-awesome-skills at commit 1e53ce2, republished under its MIT licence (© sickn33). 947 words, ~1,777 tokens.

Download SKILL.mdSave it as .claude/skills/traderspy-position-check/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
traderspy-position-check
description
Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side. Reports only; never tells the user to close or add.
category
finance
risk
safe
source
https://github.com/target1m/traderspy-mcp/tree/069aae5a84640d671f92705a2e3bc0b62efca1e0/skills/position-check
source_repo
target1m/traderspy-mcp
source_type
official
date_added
2026-09-25
author
target1m
tags
traderspy, crypto, risk-management, futures, mcp
tools
claude, cursor, gemini
license
MIT

TraderSpy Position Check

A position check answers, in order: how much room is left before this position is taken away (liquidation), how much before the user's own plan says it is wrong (stop), what the chart and the derivatives market are doing around it, and who else is positioned the same way. Report those facts with numbers. The decision — hold, trim, close, add — belongs to the person whose money it is.

When to Use

  • Use when the user asks "how's my position", "am I in trouble", "how far am I from liquidation", "should I hold or close" or "review my trades", or asks what you think of their long or short.
  • Use when the user pastes or describes a position, for example "I'm long ETH from 2,400 at 10x".
  • The skill reports and explains. It never tells the user to close, add, hedge or move a stop, and it cannot trade.

Inputs

The position always comes from the user. TraderSpy has no account tool: it cannot read a balance or an open position on any exchange, so never offer to "check the account".

Ask for whatever is missing among side, entry, leverage (and stop / target / the exchange's liquidation price if they have them). Size is optional — the analysis works in percentages. The current price is the price that get_technical_indicators returns.

Map the symbol to Binance naming for the data tools: BTC → BTCUSDT, kPEPE → 1000PEPEUSDT, xyz:AVGO → AVGOUSDT.

Calls per position (keep it to what matters)

  1. get_technical_indicators — intervals: ["1h","4h","1d"], indicators: ["rsi","macd","ema", "atr","adx","supertrend","levels"]. One call. This gives the trend on three timeframes, ATR for stop sanity and the nearest levels.
  2. get_derivatives — up to five coins in ONE call for all positions at once. Funding is a cost or an income for this position; the OI regime says whether the move is being funded.
  3. get_positions — symbol, status: "open", limit: 20. Optional; skip on a tight quota. Tells you whether tracked top traders are on the same side.

Three positions ≈ 3 + 1 (+3) calls. If the quota is tight, do derivatives for all coins first, then technicals for the position with the smallest liquidation distance.

The math (show it, briefly)

  • P&L % on margin = (mark − entry) / entry × leverage, sign-flipped for shorts; P&L % on price = the same without leverage. State both when leverage > 1.
  • Distance to liquidation = |liq − mark| / mark. With no liquidation price from the user, approximate: ≈ 100 / leverage % minus a maintenance buffer (say it is approximate; cross margin makes the real distance depend on the whole account).
  • Distance to stop = |stop − mark| / mark, and stop distance in ATRs = |stop − mark| / ATR(14) on the 4h. Under 1 ATR means the stop sits inside normal noise for that timeframe.
  • Funding per day ≈ funding.ratePct × 3 on notional; positive rate costs longs and pays shorts.

Bands for the liquidation distance: ≤ 5% → "at risk", ≤ 15% → "watch", above → "comfortable". These are labels for a distance, not instructions.

Show full SKILL.md (468 more words)Show less

The report

ALWAYS use this template per position:

<COIN> <SIDE> · <leverage>x · <marginMode>

  • Entry <entry> → mark <mark> (<±x.x%> on price, <±y%> on margin) · uPnL <$, when the size is known>
  • Liquidation <liq> — <d%> away → <at risk / watch / comfortable>
  • Stop <stop or "none stated"> — <d%> / <n> ATR(4h) away · Target <if any>
  • Chart: 1h <bias, RSI, trend> · 4h <…> · 1d <…> · confluence <aligned / mixed>
  • Nearest levels: support <price (d%)>, resistance <price (d%)>
  • Derivatives: funding <label, annualized → cost or income for this side>, OI <regime>, top traders <long %> (same side / opposite side)
  • Thesis check: what the position needs to keep working, and the level or reading that would say it has stopped working
  • Scenarios: if price goes to <nearest level against> the position shows <P&L>; at <liquidation> it is gone; at <nearest level for> it shows <P&L>

Then one line naming the position with the least room, and one plain sentence that crypto derivatives are high-risk and this is market information, not financial advice.

Facts first, labels second, no verbs of instruction. "The stop sits 0.6 ATR away, inside normal 4h noise" is a report; "move your stop" is not.

Conduct

  • Never tell the user to close, hold, add, hedge, move a stop or change leverage. Present distances, scenarios and the invalidation level; the decision is theirs. If they ask "should I close", lay out what supports staying in and what argues against, then hand it back.
  • Distances and scenarios are arithmetic on current prices and levels the tools returned; they are not predictions of where price will go.
  • Nothing in this connector trades — no order, close, transfer or withdrawal tool exists, by design. Say so when asked to act; the decision and any trade stay with the user.
  • Position details the user shares stay in the conversation; do not restate them in later unrelated answers.
  • Quote only tool results and what the user told you; if a coin is not tracked, say so.

Formulas and worked examples: references/risk-math.md.

Examples

text
I'm short SOL from 180 at 5x, liquidation around 214. How far is it, and what do the 1h/4h/1d indicators say?
I'm long ETH from 2,400 at 10x with a stop at 2,250. How does it look?
Am I in trouble on my SOL short?

Limitations

  • Needs the hosted TraderSpy MCP server connected in the client (https://mcp.traderspy.app/mcp, Streamable HTTP), authorized with OAuth or a personal key from https://traderspy.app/mcp. A free TraderSpy account is enough. Without the server the skill has no data to work from.
  • Tool calls are metered per day: 300 on the free tier, 5,000 on premium.
  • Every tool is read-only. Nothing here places, closes or modifies an order, and there is no withdrawal or transfer tool.
  • The output is market data and analysis for the user's own research, not investment advice.
  • TraderSpy cannot see anyone's exchange or TraderSpy account, so every position has to be described or pasted in chat.
  • Without a liquidationPrice the liquidation distance is an approximation; under cross margin it depends on the whole account.
  • @traderspy-technical-analysis - a full chart read on one of the coins
  • @traderspy-smart-money - who else holds the same position

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

Files

SKILL.md and 1 other file (references) in skills/traderspy-position-check of sickn33/agentic-awesome-skills.

  • SKILL.md
  • references/risk-math.md

Open the folder on GitHubat commit 1e53ce2

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Traderspy Position Check 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.

Traderspy Position Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Traderspy Position Check this skillsickn33/agentic-awesome-skills47k1 repos~1.8kAutomated safety check: PassMIT
Futures Position Sizertradermonty/claude-trading-skills3k—~2.5kAutomated safety check: PassMIT
Crypto Derivatives StrategiesHKUDS/Vibe-Trading35k—~2.4kAutomated safety check: PassMIT
Positioning Ideasphuryn/pm-skills27k—~751Automated safety check: PassMIT
Codebase Health Dashboardgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Gtm Positioning Strategygithub/awesome-copilot40k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Futures Position Sizer

    tradermonty/claude-trading-skills

    Calculate contract-based futures position sizes from a direction, entry, and stop-loss, using verified per-symbol contract specs (multiplier, tick size, tick value).

    3k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Covers three crypto-derivatives approaches: perpetual funding-rate arbitrage, futures term-structure trading in contango and backwardation, and options volatility and Greeks analysis.

    35k GitHub stars~2.4k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Positioning Ideas

    phuryn/pm-skills

    Brainstorm product positioning ideas differentiated from competitors.

    27k GitHub stars~751 tokensUpdated 22 days ago
    Marketing & SEOAuto-check passed
  • Runs a project's own type checker, linter, test runner, dead-code detector and shell linter, combines them into a weighted 0-10 score and tracks the trend.

    136k GitHub stars~11k tokensUpdated today
    DevelopmentAuto-check: notes
  • Gtm Positioning Strategy

    github/awesome-copilot

    Official

    Find and own a defensible market position. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Health

    agenticnotetaking/arscontexta

    Run condition-based vault health diagnostics. An agent skill from agenticnotetaking/arscontexta.

    3.5k GitHub stars~7.1k tokensUpdated 7 mo ago
    Auto-check: notes

More from sickn33/agentic-awesome-skills

All 1,394 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Traderspy Position Check

What does Traderspy Position Check do?

Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side. Traderspy Position Check is an agent skill from sickn33/agentic-awesome-skills. Health-check crypto futures positions the user describes, with TraderSpy data: liquidation and stop distance, multi-timeframe read, funding and top-trader side.

How do I install Traderspy Position Check in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill traderspy-position-check -a claude-code`. Or copy the skill folder (skills/traderspy-position-check in sickn33/agentic-awesome-skills) into .claude/skills/traderspy-position-check in your project. Claude Code loads it when a task matches its description.

How do I install Traderspy Position Check in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill traderspy-position-check -a codex`. Or copy the skill folder (skills/traderspy-position-check in sickn33/agentic-awesome-skills) into .agents/skills/traderspy-position-check in your project. Codex loads it when a task matches its description.

Can I use Traderspy Position Check 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 sickn33/agentic-awesome-skills --skill traderspy-position-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/traderspy-position-check, .gemini/skills/traderspy-position-check, .github/skills/traderspy-position-check and .opencode/skills/traderspy-position-check in your project.

What does Traderspy Position Check need to run?

SKILL.md names no scripts, command-line tools or credentials: Traderspy Position Check is instructions for the agent only.

Does Traderspy Position Check access the network?

SKILL.md names 2 domains. In commands or code: mcp.traderspy.app; the agent is likely to contact it when it follows the instructions. As links in the text: traderspy.app. This is read from the text; nothing was executed.

Is Traderspy Position Check 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 Traderspy Position Check use?

Traderspy Position Check is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Traderspy Position Check use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 756 tokens, read only when the agent opens those files.

What are the alternatives to Traderspy Position Check?

Skills that share tags, products or a category with Traderspy Position Check: Futures Position Sizer (tradermonty/claude-trading-skills, 3k stars), Crypto Derivatives Strategies (HKUDS/Vibe-Trading, 35k stars), Positioning Ideas (phuryn/pm-skills, 27k stars) and Codebase Health Dashboard (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Traderspy Position Check?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,304 GitHub stars. The repository holds 1,394 skills in this directory. The repository was last updated on October 6, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.