Trader Alerts
Price Alerts.
Install
npx skills add Jakeschincariol/trader-skill --skill trader-alerts -g -a claude-code -y- Repository
- Jakeschincariol/trader-skill1.1k
- Category
- Engineering
- Updated
- 21d ago
- License
- MIT
- Context cost
- Lightabout 1,266 tokens
- Runs scripts
- Yes, review before use
What it does
Price Alerts. Rings when a price target, a stop or the opening bell hits: above / below / stop rules, percent moves from the previous close, and the NYSE opening bell, each ringing once so you are not spammed. Knows NYSE hours with the 2026 and 2027 holidays and 1:00 p.m. early closes, fetches free delayed quotes (Yahoo chart JSON, Stooq CSV) one ticker at a time, and writes trader/prices.json for the other skills. Use when the user says "alert me when", "tell me if AAPL hits", "set a stop", "price target", "watch my stocks", "is the market open", "when does the market open", "get me prices", or to refresh prices before sizing, risk or tax.
trader-alerts
Price Alerts watches the numbers so the user does not have to. An alert is information, never an order: when a stop rings, nothing is sold. If the user wants to act, the normal path runs (size, risk, their yes).
${CLAUDE_SKILL_DIR} below is this skill's folder (where this SKILL.md lives).
python3 "${CLAUDE_SKILL_DIR}/alerts.py" clock # NYSE open or closed, next open
python3 "${CLAUDE_SKILL_DIR}/alerts.py" quote AAPL KO --write # -> trader/prices.json
python3 "${CLAUDE_SKILL_DIR}/alerts.py" quote --holdings --write # portfolio + targets tickers
python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol AAPL --above 350
python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol BAC --stop 50 --note "my stop"
python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --symbol KO --pct 3
python3 "${CLAUDE_SKILL_DIR}/alerts.py" add --opening-bell
python3 "${CLAUDE_SKILL_DIR}/alerts.py" check # exit 0 = something rang
python3 "${CLAUDE_SKILL_DIR}/alerts.py" list
python3 "${CLAUDE_SKILL_DIR}/alerts.py" reset aapl-above-350
What it reads and writes
| file | what |
|---|---|
trader/alerts.json | the rules (alerts.example.json in this folder) |
trader/state/alerts.json | which rules rang and when, so each rings once |
trader/prices.json | the latest quotes, merged in, for trader-budget, trader-risk, trader-tax and trader-rebalance |
Rule types
| type | rings when | rings again |
|---|---|---|
above | price at or above price | after reset, or on its own if "rearm": true and the price fell back |
below / stop | price at or below price | same |
pct_move | moved pct percent from the previous close (or ref), optional direction up or down | once per day at most |
opening_bell | the NYSE is open | once per trading day |
