Agent skill

Trader Regime

by ruvnet in ruvnet/ruflo

Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy.

MITAuto-check: notesBusiness, Finance & HR

Install Trader Regime

skills CLI
$ npx skills add ruvnet/ruflo --skill trader-regime -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo trader-regime --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-neural-trader/skills/trader-regime .claude/skills/trader-regime && 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
trader-regime
GitHub stars
74k
Token cost
~408 tokens
SKILL.md length
83 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy.

  • Works in 7 steps: Ensure neural-trader is available → Run regime detection → Get technical indicators for context → …
  • The user asks about market conditions
  • Calls npx and npm
  • Wants to pick a strategy for current conditions

What it does

Trader Regime is an agent skill from ruvnet/ruflo. Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy. Use when the user asks about market conditions, wants to pick a strategy for current conditions, or before running a backtest/signal that should be regime-aware.

Its SKILL.md is about 410 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, covering Trading and backtesting. It works with Model Context Protocol. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • The user asks about market conditions
  • Wants to pick a strategy for current conditions
  • Before running a backtest/signal that should be regime-aware

Example prompts

  • “/trader-regime”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__neural_predict

Workflow steps

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

  1. Ensure neural-trader is available
  2. Run regime detection
  3. Get technical indicators for context
  4. Use SONA for regime prediction
  5. Search for similar historical regimes
  6. Present: regime classification, confidence, recommended strategy type, historical precedents
  7. Store analysis

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • mcp__plugin_ruflo-core_ruflo__memory_store
    • mcp__plugin_ruflo-core_ruflo__memory_search
    • mcp__plugin_ruflo-core_ruflo__neural_predict

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    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

Trader Regime loads about 408 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 83 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search,

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 ruvnet/ruflo at commit 58e0ae7, republished under its MIT licence (© ruvnet). 83 words, ~408 tokens.

Download SKILL.mdSave it as .claude/skills/trader-regime/SKILL.md (or your agent's skills folder).
name
trader-regime
description
Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy. Use when the user asks about market conditions, wants to pick a strategy for current conditions, or before running a backtest/signal that should be regime-aware.
allowed-tools
Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__neural_predict
argument-hint
[--symbol SPY] [--symbols AAPL,MSFT]

Detect the current market regime using neural-trader's regime detection engine.

Steps:

  1. Ensure neural-trader is available: npm ls neural-trader 2>/dev/null || npm install --ignore-scripts neural-trader
  2. Run regime detection:
    bash
    npx neural-trader --regime-detect --symbol TICKER
    For multiple symbols:
    bash
    npx neural-trader --regime-detect --symbols "AAPL,MSFT,GOOGL,AMZN"
  3. Get technical indicators for context:
    bash
    npx neural-trader --symbol TICKER --indicators rsi,macd,bollinger,adx,atr
  4. Use SONA for regime prediction: mcp__plugin_ruflo-core_ruflo__neural_predict({ input: "indicators: RSI=X, ADX=Y, VIX=Z" })
  5. Search for similar historical regimes: mcp__plugin_ruflo-core_ruflo__memory_search({ query: "regime similar to CURRENT", namespace: "trading-analysis" })
  6. Present: regime classification, confidence, recommended strategy type, historical precedents
  7. Store analysis: mcp__plugin_ruflo-core_ruflo__memory_store({ key: "regime-DATE", value: "REGIME_ANALYSIS", namespace: "trading-analysis" })

© ruvnet, 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 plugins/ruflo-neural-trader/skills/trader-regime of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Compare with similar skills

Trader Regime 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.

Trader Regime compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trader Regime this skillruvnet/ruflo74k—~408Automated safety check: NotesMIT
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Dr Manhattanguzus/dr-manhattan204—~2kAutomated safety check: PassApache-2.0
Agentic Trading DeskOft3r/agentic-trading-desk306—~5.1kAutomated safety check: PassMIT
Okx Cex Marketdex-original/okx-agent-trade-kit1101 repos~2.7kAutomated safety check: PassMIT
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT

Similar skills

  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Dr Manhattan

    guzus/dr-manhattan

    Trade prediction markets (Polymarket, Kalshi, Opinion, Limitless, Predict.fun) using a unified CCXT-style API.

    204 GitHub stars~2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Agentic Trading Desk

    Oft3r/agentic-trading-desk

    Personal trading desk for short-term technical analysis on stocks/ETFs via Robinhood MCP.

    306 GitHub stars~5.1k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Okx Cex Market

    dex-original/okx-agent-trade-kit

    A skill your agent uses when the user asks for: price of any asset, ticker, order book, candles, OHLCV, funding rate, open interest, OI change scanner, market screener (top movers, high-volume…

    110 GitHub starsUsed in 1 repo~2.7k tokens
    Business, Finance & HRAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Trading Signals

    roman-rr/trading-skills

    Fetches live AI crypto trading signals with entry price, stop-loss, take-profit, leverage, confidence scores, and automated verification.

    119 GitHub stars~2.2k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Questions about Trader Regime

What does Trader Regime do?

Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy. Trader Regime is an agent skill from ruvnet/ruflo. Detect current market regime using npx neural-trader — bull/bear/ranging/volatile classification with recommended strategy.

When should I use Trader Regime?

Trader Regime fits situations like: the user asks about market conditions; wants to pick a strategy for current conditions; before running a backtest/signal that should be regime-aware.

How do I install Trader Regime in Claude Code?

Run `npx skills add ruvnet/ruflo --skill trader-regime -a claude-code`. Or copy the skill folder (plugins/ruflo-neural-trader/skills/trader-regime in ruvnet/ruflo) into .claude/skills/trader-regime in your project. Claude Code loads it when a task matches its description.

How do I install Trader Regime in Codex?

Run `npx skills add ruvnet/ruflo --skill trader-regime -a codex`. Or copy the skill folder (plugins/ruflo-neural-trader/skills/trader-regime in ruvnet/ruflo) into .agents/skills/trader-regime in your project. Codex loads it when a task matches its description.

Can I use Trader Regime 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 ruvnet/ruflo --skill trader-regime -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trader-regime, .gemini/skills/trader-regime, .github/skills/trader-regime and .opencode/skills/trader-regime in your project.

What does Trader Regime need to run?

Going by SKILL.md and its folder, Trader Regime needs the command-line tools its instructions call (npx and npm). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash, Read, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__neural_predict.

Does Trader Regime access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Trader Regime safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Trader Regime use?

Trader Regime 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 Trader Regime use?

About 408 tokens (SKILL.md is roughly 1.6k 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 Trader Regime?

Skills that share tags, products or a category with Trader Regime: Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars), Dr Manhattan (guzus/dr-manhattan, 204 stars), Agentic Trading Desk (Oft3r/agentic-trading-desk, 306 stars) and Okx Cex Market (dex-original/okx-agent-trade-kit, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trader Regime?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.

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