Skip to content

reddygopalkrishna/trading-skills / skills/trading-plan

trading-plan

Verified

Turn a trade idea into a complete, numbers-first plan - entry (limit, market or pattern pivot), stop options (ATR, structure, swing, pattern, percent), targets (R-multiples or next resistance), reward:risk, invalidation and position size from the account's risk rules, optionally scaled by market regime and saved to the journal. Works for stocks, ETFs, futures (contract multipliers), options underlyings and fractional crypto. Use when the user asks "how should I trade X", "where's my stop", "how many shares", "plan an entry", or after a screener/pattern hit.

FileKindSize
SKILL.mdskill md2.6 KB
scripts/_vendor/tradekit/__init__.pyscript516 B
scripts/_vendor/tradekit/alerts.pyscript7.5 KB
scripts/_vendor/tradekit/analysis.pyscript10.3 KB
scripts/_vendor/tradekit/backtest.pyscript17.8 KB
scripts/_vendor/tradekit/brokers/__init__.pyscript1022 B
scripts/_vendor/tradekit/brokers/_rest.pyscript2.7 KB
scripts/_vendor/tradekit/brokers/base.pyscript3.5 KB
scripts/_vendor/tradekit/brokers/dhan.pyscript6.8 KB
scripts/_vendor/tradekit/brokers/fyers.pyscript7.1 KB
scripts/_vendor/tradekit/brokers/groww.pyscript7.7 KB
scripts/_vendor/tradekit/brokers/kite.pyscript14.5 KB
scripts/_vendor/tradekit/brokers/paper.pyscript12.7 KB
scripts/_vendor/tradekit/brokers/upstox.pyscript7.8 KB
scripts/_vendor/tradekit/cli.pyscript2.4 KB
scripts/_vendor/tradekit/config.pyscript6.0 KB
scripts/_vendor/tradekit/data.pyscript18.5 KB
scripts/_vendor/tradekit/disclosures.pyscript17.4 KB
scripts/_vendor/tradekit/expr.pyscript19.0 KB
scripts/_vendor/tradekit/feeds.pyscript9.4 KB
scripts/_vendor/tradekit/frame.pyscript8.9 KB
scripts/_vendor/tradekit/fundamentals.pyscript6.1 KB
scripts/_vendor/tradekit/gate.pyscript8.1 KB
scripts/_vendor/tradekit/http.pyscript4.3 KB
scripts/_vendor/tradekit/indicators.pyscript13.1 KB
scripts/_vendor/tradekit/journal.pyscript11.1 KB
scripts/_vendor/tradekit/metrics.pyscript6.2 KB
scripts/_vendor/tradekit/montecarlo.pyscript7.8 KB
scripts/_vendor/tradekit/options.pyscript24.4 KB
scripts/_vendor/tradekit/patterns.pyscript12.9 KB
scripts/_vendor/tradekit/report.pyscript8.4 KB
scripts/_vendor/tradekit/risk.pyscript4.7 KB
scripts/_vendor/tradekit/sec.pyscript12.0 KB
scripts/_vendor/tradekit/session.pyscript9.4 KB
scripts/plan.pyscript12.2 KB

scripts/_vendor/tradekit/gate.py

View on GitHub
"""Pre-trade risk gate and approval tokens.

The gate turns the risk limits in config["risk"] into hard PASS/FAIL checks.
A PASS writes a short-lived approval that the trading-broker requires before it
will submit an order. This makes "no plan, no trade" mechanical, not optional.
"""

from __future__ import annotations

import datetime as dt
import hashlib
import json
from typing import Dict, List, Optional

from . import config
from .journal import Journal


def _check(name: str, ok: Optional[bool], detail: str, warn_only: bool = False) -> Dict:
    if ok is None:
        status = "warn"
    elif ok:
        status = "pass"
    else:
        status = "warn" if warn_only else "fail"
    return {"check": name, "status": status, "detail": detail}


def evaluate(trade: Dict, equity: float, journal: Optional[Journal] = None, cfg: Optional[Dict] = None,
             open_positions: Optional[List[Dict]] = None) -> Dict:
    """trade: symbol, side(long/short), entry, stop, target?, qty, setup?, thesis?"""
    cfg = cfg or config.load()
    lim = cfg["risk"]
    j = journal or Journal()
    side = "long" if str(trade.get("side", "long")).lower() in ("long", "buy") else "short"
    entry = float(trade["entry"])
    stop = float(trade["stop"]) if trade.get("stop") not in (None, "") else None
    target = float(trade["target"]) if trade.get("target") not in (None, "") else None
    qty = float(trade.get("qty") or 0)
    checks: List[Dict] = []

    checks.append(_check("kill_switch_off", not config.kill_switch_on(),
                         "kill switch is OFF" if not config.kill_switch_on() else "KILL SWITCH IS ON - trading halted"))
    has_stop = stop is not None and ((side == "long" and stop < entry) or (side == "short" and stop > entry))
    checks.append(_check("stop_defined", has_stop,
                         f"stop {stop} on the correct side of entry {entry}" if has_stop
                         else "a valid stop is required (below entry for long, above for short)"))
    checks.append(_check("plan_documented", bool(trade.get("setup") or trade.get("thesis")),
                         "setup/thesis recorded" if (trade.get("setup") or trade.get("thesis"))
                         else "add --setup or --thesis: why this trade, what invalidates it", warn_only=True))
    checks.append(_check("qty_positive", qty > 0, f"qty {qty:g}" if qty > 0 else "qty must be > 0"))

    risk_amt = abs(entry - stop) * qty if has_stop else None
    if risk_amt is not None:
        rp = risk_amt / equity * 100
        checks.append(_check("risk_per_trade", rp <= lim["risk_per_trade_pct"] + 1e-9,
                             f"risk {rp:.2f}% of equity (limit {lim['risk_per_trade_pct']}%)"))
    if target is not None and has_stop:
        rr = abs(target - entry) / abs(entry - stop)
        checks.append(_check("reward_risk", rr >= lim["min_reward_risk"],
                             f"reward:risk {rr:.2f} (minimum {lim['min_reward_risk']})"))
    else:
        checks.append(_check("reward_risk", None, "no target given - reward:risk not checked"))

    notional = entry * qty
    pp = notional / equity * 100 if equity else 100
    checks.append(_check("position_size", pp <= lim["max_position_pct"] + 1e-9,
                         f"position {pp:.1f}% of equity (limit {lim['max_position_pct']}%)"))

    open_trades = j.list(status="open")
    heat = 0.0
    for t in open_trades:
        if t["stop"] is not None and t["entry_price"] is not None and t["qty"]:
            heat += abs(t["entry_price"] - t["stop"]) * float(t["qty"])
    total_heat = (heat + (risk_amt or 0)) / equity * 100
    checks.append(_check("portfolio_heat", total_heat <= lim["max_open_risk_pct"] + 1e-9,
                         f"open risk incl. this trade {total_heat:.2f}% (limit {lim['max_open_risk_pct']}%)"))

    n_open = len(open_trades)
    if open_positions is not None:
        n_open = max(n_open, len(open_positions))
    checks.append(_check("max_positions", n_open < lim["max_open_positions"],
                         f"{n_open} open positions (limit {lim['max_open_positions']})"))

    dup = any(t["symbol"] == trade["symbol"] for t in open_trades) or any(
        p.get("symbol") == trade["symbol"] for p in (open_positions or []))
    checks.append(_check("no_duplicate", not dup, "no existing position in this symbol" if not dup
                         else "already holding this symbol - adding is a new decision; size it as such",
                         warn_only=True))

    today_pnl = sum(t["pnl"] or 0 for t in j.closed_today())
    dl = -today_pnl / equity * 100 if today_pnl < 0 else 0.0
    checks.append(_check("daily_loss_limit", dl < lim["max_daily_loss_pct"],
                         f"today's realized loss {dl:.2f}% (limit {lim['max_daily_loss_pct']}%)"))

    streak = j.consecutive_losses()
    checks.append(_check("loss_streak", streak < lim["max_consecutive_losses"],
                         f"{streak} consecutive losses (pause at {lim['max_consecutive_losses']})"))

    dd = drawdown_from_peak(j, equity)
    if dd is not None:
        checks.append(_check("max_drawdown", dd < lim["max_drawdown_pct"],
                             f"account {dd:.2f}% below its journal peak (limit {lim['max_drawdown_pct']}%)"))

    fails = [c for c in checks if c["status"] == "fail"]
    warns = [c for c in checks if c["status"] == "warn"]
    verdict = "FAIL" if fails else ("PASS_WITH_WARNINGS" if warns else "PASS")
    return {"verdict": verdict, "symbol": trade["symbol"], "side": side, "entry": entry, "stop": stop,
            "setup": trade.get("setup") or "", "thesis": trade.get("thesis") or "",
            "target": target, "qty": qty, "risk_amount": round(risk_amt, 2) if risk_amt is not None else None,
            "equity_used": equity, "checks": checks,
            "blocking": [c["check"] for c in fails], "warnings": [c["check"] for c in warns]}


def drawdown_from_peak(j: Journal, equity: float) -> Optional[float]:
    closed = j.list(status="closed")
    if not closed:
        return None
    realized = sum(t["pnl"] or 0 for t in closed)
    start = equity - realized
    eq = start
    peak = start
    for t in closed:
        eq += t["pnl"] or 0
        peak = max(peak, eq)
    return max(0.0, (1 - equity / peak) * 100) if peak > 0 else None


# ------------------------------------------------------------------ approvals

def _hash(symbol: str, side: str, qty: float, stop: Optional[float]) -> str:
    raw = f"{symbol}|{side}|{float(qty):g}|{'' if stop is None else round(float(stop), 6)}"
    return hashlib.sha256(raw.encode()).hexdigest()[:12]


def write_approval(result: Dict, trade_id: Optional[int] = None) -> Dict:
    cfg = config.load()
    now = dt.datetime.now()
    ttl = int(cfg["risk"].get("approval_ttl_minutes", 30))
    h = _hash(result["symbol"], result["side"], result["qty"], result["stop"])
    appr = {"approval_id": "A" + h, "symbol": result["symbol"], "side": result["side"], "qty": result["qty"],
            "entry": result["entry"], "stop": result["stop"], "target": result["target"],
            "verdict": result["verdict"], "trade_id": trade_id, "setup": result.get("setup", ""),
            "thesis": result.get("thesis", ""),
            "created": now.isoformat(timespec="seconds"),
            "expires": (now + dt.timedelta(minutes=ttl)).isoformat(timespec="seconds")}
    config.path("approvals", appr["approval_id"] + ".json").write_text(json.dumps(appr, indent=2))
    return appr


def find_approval(symbol: str, side: str, qty: float, stop: Optional[float]) -> Optional[Dict]:
    side = "long" if side in ("buy", "long") else "short"
    f = config.path("approvals", "A" + _hash(symbol, side, qty, stop) + ".json")
    if not f.exists():
        return None
    a = json.loads(f.read_text())
    if dt.datetime.fromisoformat(a["expires"]) < dt.datetime.now():
        return None
    return a


def consume_approval(approval_id: str) -> None:
    f = config.path("approvals", approval_id + ".json")
    if f.exists():
        f.unlink()


def audit(event: str, **data) -> None:
    rec = {"time": dt.datetime.now().isoformat(timespec="seconds"), "event": event, **data}
    with open(config.path("audit.log"), "a") as fh:
        fh.write(json.dumps(rec, default=str) + "\n")
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall