pre-trade-discipline-gate
Evaluate a local pre-trade checklist before manual order entry, blocking planless, oversized, revenge-risk, market-regime-blocked, or circuit-breaker-blocked entries while journaling the decision for trader-memory-core review.
Install / Use
npx skills add tradermonty/claude-trading-skills --skill pre-trade-discipline-gateInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of pre-trade-discipline-gate
pre-trade-discipline-gate scores 91/100 on our quality scale, 209th of 642 Marketing skills we index (top 33%).
Its SKILL.md is 6.2 KB long, well organised into 12 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 2,885 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so pre-trade-discipline-gate is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
pre-trade-discipline-gate compared with similar skills
All 4 of these similar skills score higher than pre-trade-discipline-gate; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| pre-trade-discipline-gate (this skill)by tradermonty | 91 | 2.9k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install pre-trade-discipline-gate?
- Run
npx skills add tradermonty/claude-trading-skills --skill pre-trade-discipline-gate. The install tabs above show the steps for each supported agent. - Which AI agents does pre-trade-discipline-gate work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is pre-trade-discipline-gate safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is pre-trade-discipline-gate still maintained?
- The repository was last updated about 2 months ago, so pre-trade-discipline-gate is actively maintained.
Skill content
View source on GitHubname: pre-trade-discipline-gate description: Evaluate a local pre-trade checklist before manual order entry, blocking planless, oversized, revenge-risk, market-regime-blocked, or circuit-breaker-blocked entries while journaling the decision for trader-memory-core review.
Pre-Trade Discipline Gate
Overview
Evaluate whether a planned manual order should proceed before it is placed at the broker. This skill reads a local checklist plus optional market-regime, circuit-breaker, and trader-memory-core artifacts. It produces a pre_trade_discipline_decision artifact and can link that artifact back to the related thesis without changing the thesis review schedule.
The gate is intentionally offline. It does not place orders, cancel orders, call a broker API, or fetch market data.
When to Use
- Immediately before placing any manual entry order
- When a candidate has passed chart validation and position sizing
- After a recent loss, to avoid revenge trades during the cooldown window
- When the workflow has an upstream
exposure_decisionandcircuit_breaker_decision - When you want checklist adherence to be visible in later trader-memory-core reviews
Prerequisites
- Python 3.9+
- A local JSON or YAML answers file with candidate-level checklist answers
- Optional trader-memory-core thesis state under
state/theses/ - Optional
exposure_decisionJSON from market-regime-daily / exposure-coach - Optional
circuit_breaker_decisionJSON from drawdown-circuit-breaker
Workflow
Step 1: Prepare the Checklist
Create a JSON or YAML file with candidate answers. Only actionable manual-order intents are gated. Watchlist and ignore intents are journaled as NO_ACTIONABLE_ORDERS.
{
"candidates": [
{
"symbol": "AAPL",
"thesis_id": "th_aapl_gm_20260703_0001",
"order_intent": "ENTRY_READY",
"entry_in_written_plan": true,
"stop_predefined": true,
"size_within_plan": true,
"planned_risk_dollars": 500,
"actual_risk_dollars": 500,
"notes": "Entry matches the journaled breakout plan."
}
]
}
Actionable intents are ENTRY_READY, ACTIONABLE, ACTIONABLE_DAY1, and MANUAL_ORDER. Non-actionable intents such as WATCHLIST, DELAYED_EP_WATCH, PEAD_HANDOFF, IGNORE, and REJECTED are recorded but do not create an order permission.
Provide both planned_risk_dollars and actual_risk_dollars for every actionable candidate. Use a finite, non-negative number or numeric string; zero is valid. Treat missing values, booleans, non-numeric strings, NaN, infinities, and negative values as REVIEW_REQUIRED inputs and review them before placing an order.
Step 2: Run the Gate
python3 skills/pre-trade-discipline-gate/scripts/check_pre_trade_discipline.py \
--answers-file state/manual-entry-checklist.json \
--state-dir state/theses \
--market-regime-decision reports/exposure_decision_latest.json \
--circuit-breaker-decision reports/circuit_breaker_decision_latest.json \
--output-dir reports/pre-trade-discipline \
--journal-dir state/journal/pre-trade-discipline
Set --as-of for deterministic testing or backfills:
python3 skills/pre-trade-discipline-gate/scripts/check_pre_trade_discipline.py \
--answers-file state/manual-entry-checklist.json \
--as-of 2026-07-03T12:00:00-04:00
Step 3: Interpret the Decision
| Decision | Meaning |
|---|---|
| GO | All actionable manual-order candidates passed the checklist and upstream gates |
| REVIEW_REQUIRED | Inputs are missing, unknown, or journaling failed; do not place orders until reviewed |
| NO_GO | At least one actionable candidate violated a discipline rule |
| NO_ACTIONABLE_ORDERS | The file contains no actionable manual orders; nothing should be placed |
By default the CLI exits 0 for every valid decision and exits 1 only for input or runtime errors. Use --fail-on-non-go when a shell pipeline should return 2 for any non-GO decision.
Rules
The gate blocks an actionable candidate when:
- The entry is not confirmed in the written plan
- The stop is not predefined
- The size is not confirmed within plan
- Either risk-dollar field is missing or is not a finite, non-negative number (
REVIEW_REQUIRED) actual_risk_dollarsexceedsplanned_risk_dollars- trader-memory-core has a losing exit or partial loss inside the revenge window
- exposure-coach recommendation is
REDUCE_ONLYorCASH_PRIORITY - drawdown-circuit-breaker recommendation is
COOLDOWN,HALTED, orTRADING_HALTED
Missing or unreadable market-regime or circuit-breaker artifacts produce REVIEW_REQUIRED for actionable orders. If no actionable order exists, the result remains NO_ACTIONABLE_ORDERS.
Outputs
The script writes:
pre_trade_discipline_decision_YYYY-MM-DD_HHMMSS.json- A matching markdown report unless
--json-onlyis set - A JSONL journal row under
state/journal/pre-trade-discipline/when--journal-diris provided
Each candidate result includes a checklist_answers object with the written-plan, stop, size, risk-dollar, and notes answers used for the decision, so later reviews can audit what was answered at order time. Invalid risk-dollar values are stored as JSON null. Valid JSON decimals that cannot round-trip through a binary float are retained as numeric strings so underflow or precision loss cannot change the gate decision.
If a candidate includes thesis_id and --state-dir is provided, the JSON report is linked into the thesis linked_reports list using trader-memory-core link_report. The skill does not call mark_reviewed and does not change monitoring review dates.
Resources
scripts/check_pre_trade_discipline.py- Main CLI and rule enginereferences/discipline_gate_framework.md- Rule definitions and integration notesskills/trader-memory-core/schemas/thesis.schema.json- Thesis state schema
Key Principles
- Manual execution only - The output is a pre-broker checklist gate, not an order router.
- Written plan first - No written entry plan, stop, or size confirmation means no manual entry.
- Producer-compatible state reading - Revenge-risk detection follows trader-memory-core timestamp and outcome behavior.
- Journal without review side effects - The gate links reports to theses without advancing review schedules.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
