К основному содержанию
скилл CX Codex

trader-risk · jakeschincariol — скилл для Claude Code: что делает и как установить

Скилл trader-risk для Claude Code проверяет торговые заявки по лимитам риска до отправки брокеру. Он блокирует сделки без стопа, с превышением дневного убытка или вне торгового окна.

MIT ★ 9 067 обновлён 2026-10-20

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill
Открыть на GitHub

Что делает trader-risk

Инструмент валидирует предложенные ордера из файла trader/orders.json перед обращением к брокеру через скрипт check.py. Скилл сверяет параметры сделок с trader/config.json: проверяет наличие стоп-лосса, соотношение прибыли к риску, допустимый размер позиции и остаток наличных. Любая заявка с превышением лимита получает статус BLOCK, который исключает её исполнение.

Для расчёта риска по рыночным заявкам скрипт берёт максимальную цену между планом и свежей котировкой из trader/prices.json возрастом до 15 минут. Временное окно рассчитывается по биржевому времени Нью-Йорка с учётом праздников NYSE, при этом закрывающие сделки никогда не блокируются дневными ограничениями. Свои вердикты с хэшем каждого ордера инструмент записывает в trader/state/risk.json.

Какие задачи решает

  • проверить торговый план на превышение дневного лимита потерь
  • заблокировать ордер без обязательного стоп-лосса
  • отсечь открытие позиций вне торговой сессии Нью-Йорка
  • исключить повторную отправку дублирующей заявки

Примеры запросов агенту

  • Проверь текущий файл trader/orders.json на соответствие лимитам риска
  • Оцени риск по запланированной сделке перед запуском trader-broker
  • Посчитай, сколько лимита дневного убытка уже израсходовано сегодня

Как установить trader-risk

1Через маркетплейс плагинов

/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill

Команда ставит плагин day-trader-skill целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Jakeschincariol/day-trader-skill --skill trader-risk -a claude-code

3Вручную: положить файлы

~/.claude/skills/trader-risk/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/trader-risk/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о trader-risk

Как установить trader-risk в Claude Code?

Сначала выполняется команда /plugin marketplace add Jakeschincariol/day-trader-skill, затем /plugin install day-trader-skill@day-trader-skill.

Что делает trader-risk?

Скрипт проверяет параметры запланированных ордеров на соответствие лимитам риска, включая размер позиции, стоп-лосс, торговое окно и допустимую дневную просадку. Заявки с нарушениями помечаются статусом BLOCK и не передаются брокеру.

Что нужно для работы trader-risk?

Для запуска требуется Python 3 и подготовленные конфигурационные JSON-файлы с лимитами, портфелем и свежими ценами в каталоге trader/.

Исходный текст

SKILL.md · MIT
---
name: trader-risk
description: >-
  Risk Manager. Checks every trade against your limits and stops anything
  over them, before it can reach the broker. For a day trade: a stop is
  required, the loss at the stop must fit your max loss per trade (measured
  from the higher of the plan's entry and a fresh price), reward:risk must
  meet your minimum, the day's total risk must fit your daily loss limit, no
  more than your trades per day, and no new entries outside your entry
  window or when the market is closed. It also keeps the basics: blocked
  tickers, order size, position cap, cash buffer, margin, short sales,
  options and crypto, malformed or bad bracket orders, duplicates and a daily
  order limit. Getting out is never blocked by a day limit. Prints PASS or
  BLOCK with the reason and records the verdicts so trader-broker only shows
  an order that passed. Use when the user says "check my order", "is this
  safe", "risk check", "does this break my rules", "can I take this trade",
  "how much have I risked today", or before /trader-broker, always.
argument-hint: "[path to orders.json]"
---

# trader-risk

The Risk Manager is the gate between a proposal and the broker. Every order
written by trader-budget or trader-broker's flatten passes through it. A
BLOCK is final for that order: it does not go to the user for a yes, and it
does not go to the broker. Most people who day trade lose money. These limits
keep each loss and each day's losses small. They do not make a trade win.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/check.py"                           # trader/ files; writes trader/state/risk.json
python3 "${CLAUDE_SKILL_DIR}/check.py" --json
python3 "${CLAUDE_SKILL_DIR}/check.py" --no-write                # look without recording
python3 "${CLAUDE_SKILL_DIR}/check.py" --now "2026-10-19 10:15"  # pin the clock (New York time)
```

## What it reads and writes

| file | what |
| --- | --- |
| `trader/orders.json` | the proposed orders (trader-budget, or trader-broker's flatten) |
| `trader/config.json` | the limits (trader-budget ships `config.example.json`) |
| `trader/portfolio.json` | cash and holdings; if missing, a fresh account funded with the budget |
| `trader/prices.json` | a fresh price raises the entry it measures risk from; also values holdings |
| `trader/state/broker.json` | what was placed today: duplicates, trades per day, daily loss, day trades |
| `trader/state/risk.json` | the verdicts it writes, with a fingerprint of each exact order |

## Entries and exits

An **entry** opens or adds to a position: a buy, or a sell that would go
short. An **exit** only reduces what you already hold. Getting out must
always be possible, so an exit is checked for format, asset and short sales
only. Every other rule (day limits, entry window, loss, reward:risk, blocked
list, size, duplicates) turns into a warning for an exit, never a BLOCK.

## The checks

Orders are checked in file order, as if each passed order had filled, so a
batch that is fine order by order but breaks a limit together is caught.

| check | blocks when |
| --- | --- |
| format | no symbol, side not buy or sell, both or neither of qty and notional, a notional order that is not market + day (Alpaca's rule), a limit order with no limit price; a bracket that is not whole shares, not `day` or `gtc`, or misses its stop-loss or take-profit |
| asset | an option symbol while `allow_options` is false; crypto or anything that is not a US stock or ETF ticker |
| short | a sell of more than you hold (`allow_short` false) |
| blocked | (entries) the ticker is on the `blocked` list |
| size | (entries) under `min_order_usd` or over `max_order_usd` |
| position | (entries) the stock would be over `max_position_pct` of the account |
| cash | (entries) the buy would leave less than the cash buffer, or need margin |
| stop | (entries) no stop while `require_stop` is true (a bracket `stop_loss_stop_price`, or the order's plan stop); a stop on the wrong side of the entry |
| loss | (entries) qty x (entry minus stop) over `max_loss_per_trade_usd` |
| reward:risk | (entries) (target minus entry) / (entry minus stop) under `min_reward_risk` |
| daily loss | (entries) the max losses at the stops of today's entries, plus this one, over `max_daily_loss_usd` |
| trades | (entries) `max_trades_per_day` entries already placed today |
| window | (entries) before `no_entries_before` or after `no_entries_after`, or the market is closed |
| pdt | (entries, only with `pdt_guard` true) 3 day trades already in the last 5 business days |
| duplicate | (entries) the same symbol and side twice in one batch, or already placed today |
| daily limit | (entries) `max_orders_per_day` orders already placed today |

How the numbers work:

- **The entry it measures from**: the limit price for a limit order. For a
  market order, the HIGHER of the plan's entry and a fresh price from
  `trader/prices.json` (under 15 minutes old). A plan written at 10:15 cannot
  understate the risk at 10:55 after the price ran up. An older price is not
  used, and it says so.
- **Daily loss** counts the full max loss of every entry placed today, win or
  lose, as trader-broker logged it. Three full-size trades use up a $150 day.
- **The window** is New York time, worked out in the tool (daylight saving
  included), never from the computer's clock zone. Weekends and NYSE holidays
  are closed. On a 1:00 p.m. early close the window ends 3 hours earlier too.
  Set both `no_entries_*` to null to switch the window off.
- **pdt_guard** (off by default) counts a day trade as a symbol bought and
  sold on the same day in the log, plus any entry placed today (it is meant
  to be flat by the close). FINRA removed the $25,000 pattern-day-trader
  minimum (Regulatory Notice 26-10, effective June 4, 2026; firms may phase
  in until October 20, 2027), so some brokers still apply the old rule: turn
  `pdt_guard` on if yours does.

Warnings do not block, but say them to the user: a LIVE account, a number
sent as a number instead of a string, a stop that lives only in the plan and
not at the broker, a price too old to use, an early close today.

## Steps

1. If the price may have moved since the plan, refresh it first
   (trader-alerts: `alerts.py quote TSLA --write`).
2. Run `check.py`. Exit code 0 means every order passed, 1 means at least one
   was blocked.
3. Tell the user the result in plain words, order by order: the max loss at
   the stop, reward:risk, and how much of today's limits it uses. For a
   BLOCK, give the reason and the fix (fewer shares, a closer stop from
   trader-exit, wait for the window, or skip the trade). Never change a
   limit yourself.
4. If the order changes in any way, run the check again. trader-broker matches
   each order to its verdict by fingerprint, so an edited order is not ready
   until it passes again, and a verdict from yesterday does not count today.

## Example: the reel

The TSLA bracket from trader-budget at 10:15 AM on Monday 2026-10-19, on a
fresh $5,000 paper account with the example config:

```
PASS  #1 buy TSLA 8 shares, entry
          entry 364.18 (the plan's entry), stop 358.32, target 370.04: risk 5.86 a share
          max loss $46.88 (limit $50), reward:risk 1.00 (min 1)
          today before this: 0 of 3 trades, $0 of $150 daily loss

1 passed, 0 blocked at 2026-10-19 10:15 New York. Cash after the passed orders: $2,086.56 (paper account).
```

One more share and it is blocked:

```
BLOCK #1 buy TSLA 9 shares, entry
          entry 364.18 (the plan's entry), stop 358.32, target 370.04: risk 5.86 a share
          max loss $52.74 (limit $50), reward:risk 1.00 (min 1)
          today before this: 0 of 3 trades, $0 of $150 daily loss
        - loss: 9 shares x 5.86 risk a share = $52.74 at the stop, over your $50 max loss per trade
```

The same 8 shares checked at 10:55 with the real 10:52 quote (366.48) in
`trader/prices.json` are blocked twice: 8 x 8.16 = $65.28 at the stop, and
reward:risk 0.44. At 9:40 they are blocked by the window (no new entries
before 9:45). The 3:55 PM sell that closes the position passes, even though
it is after the 3:30 entry cutoff: it is an exit.

## Rules

- A PASS only means the order is allowed to be shown to the user. It is not a yes.
- Every number comes from the config, the order, the portfolio, the prices or the broker log.
- Free Yahoo prices are unofficial and can lag; the broker's price is the one that fills, and a
  stop can fill worse than its price in a fast market.

## What it never does

It never places an order, never edits an order to make it pass, never
loosens a limit, never blocks a sell that only gets the user out, and never
treats a PASS as the user's yes.

## Safety

- Education and tooling, not financial advice. A PASS is a rules check, not a recommendation.
- Paper trading by default (`"paper": true`). Going live is the user's own decision, in their own config.
- Nothing in this pack places an order except trader-broker, and only when all three hold: trader-risk
  passed that exact order today, the user typed an explicit yes for that one order in the chat, and the
  user clicked Allow once on Claude's own card because the order tool is set to "Needs approval"
  (Customize > Connectors > tool permissions). Never set an order tool to "Always allow".
- No options, margin, short selling or leverage unless the config allows it and the user confirms.
- Broker keys live in environment variables or the Claude Desktop config, never in the chat.

© Jake Schincariol · MIT · Jakeschincariol/day-trader-skill

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →

Сначала — trader-risk от других авторов.

trader-risk ruvnet Скилл trader-risk оценивает VaR и CVaR портфеля через движок neural-trader, а также отслеживает лимиты просадок и статус защитных механизмов. CX Codex +1 732установок trader-memory-core tradermonty Скилл trader-memory-core для Claude Code ведёт инвестиционные тезисы от скрининга до закрытия сделки с расчётом P&L. Запускается при фразах вроде «register thesis» или «trading journal». CX Codex +1 3 700установок position-sizer tradermonty Скилл position-sizer рассчитывает размер позиции в акциях на основе риска на сделку, волатильности ATR или критерия Келли. Помогает определить число бумаг перед входом в сделку. CX Codex +1 4 400установок risk-management 0xhubed Скилл risk-management задаёт правила управления рисками для торговых агентов на основе 8500 сделок из соревнований. Помогает рассчитывать размер позиций и выставлять стоп-лоссы. CX Codex +1 2 100установок risk-management-trading omer-metin Скилл risk-management-trading для Claude Code помогает оценивать размер позиции, волатильность и риск портфеля. Он подключается к запросам о стоп-лоссах, просадках и риске сделки. CX Codex +1 415установок trading-risk-manager davila7 Субагент trading-risk-manager помогает частным трейдерам рассчитывать размер позиций, оценивать риск ликвидации по деривативам и контролировать просадку портфеля. CX Codex 82установок operational-risk JoelLewis Скилл operational-risk помогает выявлять, оценивать и устранять операционные риски в трейдинге и брокерских операциях по стандартам Basel и FINRA. CX Codex +1 731установок

Из того же набора12

Весь набор →
trader-exit Скилл trader-exit для Claude Code рассчитывает уровни стоп-лосса и тейк-профита перед входом в лонг-позицию. Запускается по запросам вроде «where's my stop» или сразу после срабатывания trader-entry. CX Codex +1 ★ 9 067звёзд репо trader-pelosi Скилл trader-pelosi для Claude Code отслеживает биржевые сделки членов Конгресса США по отчётам PTR. Находит новые публикации в базе Палаты представителей и разбирает PDF на строки. CX Codex +1 ★ 9 067звёзд репо trader-entry Скилл trader-entry для Claude Code следит за барами и называет момент входа после закрытия выше уровня. Запускается по запросу следить за тикером или проверить пробой. CX Codex +1 ★ 9 067звёзд репо trader-alerts Скилл trader-alerts для Claude Code отслеживает ценовые уровни акций, стопы и время до закрытия биржи NYSE. Срабатывает при вызове команд проверки котировок или сразу после формирования торгового плана. CX Codex +1 ★ 9 067звёзд репо trader-budget Скилл trader-budget для Claude Code рассчитывает размер позиции по бюджету и максимальному убытку. Запускается по запросу о числе акций или после плана от trader-exit. CX Codex +1 ★ 9 067звёзд репо trader-timemachine Скилл trader-timemachine для Claude Code моделирует сделку по 5-минутным барам и проверяет прошлые срабатывания сетапа. Запускается перед расчётом позиции. CX Codex +1 ★ 9 067звёзд репо trader-scanner Скилл trader-scanner для Claude Code сканирует графики акций США и находит сетапы перед открытием торгов и внутри дня. Результаты отбора записываются в trader/watchlist.json. CX Codex +1 ★ 9 067звёзд репо trader-broker Скилл trader-broker для Claude Code отправляет одобренные ордера брокеру через два подтверждения. Включается по просьбе купить, продать или закрыть позицию. CX Codex +1 ★ 9 067звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой