exposure-coach
Generate a one-page Market Posture summary with net exposure ceiling, growth-vs-value bias, participation breadth, and new-entry-allowed vs cash-priority recommendation by integrating signals from breadth, regime, and flow analysis skills.
By tradermonty · 1,972 installs
npx skills add tradermonty/claude-trading-skills --skill exposure-coach
Source repository · Upstream listing
Exposure Coach
Overview
Exposure Coach synthesizes outputs from market breadth analyzer, uptrend analyzer, macro regime detector, market top detector, ftd detector, theme detector, sector analyst, and institutional flow tracker into a unified control plane decision. The skill answers the solo trader's core question: "How much capital should I commit to equities right now?" before any individual stock analysis begins.
When to Use
Before initiating any new stock positions to determine appropriate capital commitment
At the start of each trading week to calibrate portfolio exposure
When multiple market signals conflict and a unified posture is needed
After significant macro or market events to reassess exposure ceiling
When transitioning between market regimes (broadening, concentration, contraction)
Prerequisites
Python 3.9+
FMP API key (set FMP API KEY environment variable) for institutional flow tracker data
Input JSON files from upstream skills (see Workflow Step 1)
Standard library + argparse , json , datetime
Workflow
Step 1: Gather Upstream Skill Outputs
Collect the most recent JSON outputs from integrated skills. Each file provides a specific signal dimension:
Skill Output File Pattern Signal Provided
market breadth analyzer breadth .json Advance/decline ratios, new highs/lows
uptrend analyzer uptrend .json Uptrend participation percentage
macro regime detector regime .json Current regime (Concentration, Broadening, etc.)
market top detector top risk .json Distribution day count, top probability score
ftd detector ftd .json Follow Through Day quality (market bottom confirmation)
theme detector theme detector .json or theme .json Active investment themes and rotation
sector analyst sector .json Sector performance rankings
institutional flow tracker institutional .json Net institutional buying/selling
Step 2: Run Exposure Scoring Engine
Execute the exposure scoring script with paths to upstream outputs:
The script accepts partial inputs; missing files reduce confidence but do not block execution.
Canonical macro regime reports must include nested regime.confidence and
composite.data quality with valid integer component counts. Missing or malformed
availability metadata, very low confidence, and zero usable components are
treated as missing critical input. They do not contribute a regime score or bias,
and the normal missing input haircut and confidence cap apply. Never override this
degradation by manually copying the report's regime label into the exposure decision.
Verification pitfall: After each run, inspect the generated JSON fields inputs provided and inputs missing . If a file you passed on the CLI still appears in inputs missing (for example a theme detector JSON that the exposure engine did not recognize), report the affected dimension as degraded and keep confidence capped; do not assume the supplied input was incorporated just because the CLI argument was present.
Theme detector ingestion caveat: The theme detector commonly emits theme detector YYYY MM DD HHMMSS.json with a themes object. If that file is not recognized by calculate exposure.py and theme remains in inputs missing , do not fold theme strength into the exposure ceiling manually. Instead, keep the Exposure Coach confidence capped, state that the theme dimension was not incorporated, and summarize theme/sector findings separately in the broader trading brief.
Step 3: Interpret the Market Posture Summary
Review the generated posture report containing:
1. Exposure Ceiling Maximum recommended equity allocation (0 100%)
2. Bias Direction Growth vs Value tilt based on regime and flow
3. Participation Assessment Broad (healthy) vs Narrow (fragile) market
4. Action Recommendation NEW ENTRY ALLOWED, REDUCE ONLY, or CASH PRIORITY
5. Confidence Level HIGH, MEDIUM, or LOW based on input completeness
Step 4: Apply Exposure Guidance
Map the posture recommendation to portfolio actions:
Recommendation Action
NEW ENTRY ALLOWED Proceed with stock level analysis and new positions
REDUCE ONLY No new entries; trim existing positions on strength
CASH PRIORITY Raise cash aggressively; avoid all new commitments
Output Format
JSON Report
Markdown Report
The markdown report provides a one page summary suitable for quick review:
Reports are saved to reports/ with filenames exposure posture YYYY MM DD HHMMSS.{json,md} .
Resources
scripts/calculate exposure.py Main orchestrator that scores and synthesizes inputs
references/exposure framework.md Scoring rules and threshold definitions
references/regime exposure map.md Regime to exposure ceiling mappings
Key Principles
1. Safety First Default to lower exposure when inputs are incomplete or conflicting
2. Regime Alignment Let macro regime set the baseline; breadth adjusts within bounds
3. Actionable Output Always produce a clear recommendation, not just data aggregation