Portfolio Stress Test Skill
Parse $ARGUMENTS to determine the portfolio symbol list and scenario, then run the following command.
Execution Command
python3 /Users/kikuchihiroyuki/stock-skills/.claude/skills/stress-test/scripts/run_stress_test.py --portfolio <symbols> [--scenario <scenario>] [--weights <weights>]
Natural Language Routing
For natural language → skill selection, see .claude/rules/intent-routing.md.
Argument Parsing Rules
portfolio (symbol list — required)
Extract a comma-separated symbol list from user input. Convert space-separated input to comma-separated.
| User Input Example |
--portfolio Value |
7203.T,AAPL,D05.SI |
7203.T,AAPL,D05.SI |
7203.T AAPL D05.SI |
7203.T,AAPL,D05.SI |
Toyota Apple |
Convert to corresponding tickers first |
weights (holding ratios — optional)
Comma-separated ratio list matching the number of symbols. Defaults to equal weights (1/N per symbol).
| User Input Example |
--weights Value |
0.5,0.3,0.2 |
0.5,0.3,0.2 |
50%,30%,20% |
0.5,0.3,0.2 (convert percentages to decimals) |
| omitted |
Equal weight 1/N per symbol |
Scenario List
| Scenario |
Description |
| triple-meltdown |
Equities, FX, and bonds fall simultaneously. Stress across all asset classes |
| usd-jpy-surge |
Sharp JPY depreciation. Rising import costs; overseas assets appreciate in JPY terms |
| us-recession |
US economic downturn. Global demand contraction, risk-off |
| boj-rate-hike |
Rising Japanese interest rates. Banks up, growth stocks and REITs down |
| us-china-conflict |
Escalating trade friction. Supply chain disruption; hit to semiconductors and manufacturing |
| inflation-resurgence |
Rising prices again. Real purchasing power declines; rate hike expectations |
| tech-crash |
NASDAQ -30%. AI expectations collapse; tech stocks hit hard, flight to quality |
| jpy-appreciation |
USD/JPY -20 yen. Foreign asset JPY-denominated values fall; hit to exporters |
| custom |
User-specified scenario interpreted from natural language |
Output Format (10-Step Pipeline)
Present results in the following structured steps.
Step 1: Portfolio Overview
- Symbol list (symbol, name, sector, weight)
- Total market cap (estimated)
Step 2: Concentration Analysis
- Sector HHI / Region HHI / Currency HHI
- Identify highest concentration axis
- Risk level judgment (diversified / somewhat concentrated / dangerously concentrated)
Step 3: Shock Sensitivity Scores
- Assessment of each stock's beta, financial health, and valuation resilience
- Per-symbol shock sensitivity score (0–100)
Step 4: Scenario Definition
- Applied scenario name and description
- Macro variable changes (assumed movements in interest rates, FX, equities)
Step 5: Per-Symbol Impact Estimates
- Estimated loss rate per symbol
- Application of concentration multiplier
- Portfolio-weighted impact
Step 6: Portfolio-Wide Impact
- Estimated portfolio-wide loss rate
- Largest loss contributor
Step 6b: Correlation Analysis (KIK-352)
- Cross-symbol correlation matrix (Pearson correlation, 1-year daily returns)
- High-correlation pairs detection (|r| >= 0.7)
- Factor decomposition: regress each symbol against macro variables (USD/JPY, Nikkei 225, S&P 500, crude oil, US 10-year yield)
- LLM interpretation: For residual correlations not explained by factor regression, use domain knowledge to infer causes (e.g., supply chain dependencies, shared customer base). Clearly separate "confirmed factors (statistical)" from "inferred factors (estimated)"
Step 6c: VaR (Historical Data-Based Risk Metrics) (KIK-352)
- Calculate portfolio weighted returns from 1-year daily return history
- 95% VaR / 99% VaR (daily and monthly)
- Explain the difference from the scenario analysis (tail risk) in the stress test
Step 7: Causal Chain Analysis
- Explanation of cascading effects when the scenario occurs
- Cross-sector propagation paths
Step 8: Overall Assessment + Recommended Actions (KIK-352)
- Specific risk mitigation proposals (rule-based auto-generated + Claude supplement)
- Recommendations integrating concentration, correlation, VaR, and stress test results
- Hedge candidates (symbols and sectors)
- LLM supplement: In addition to rule-based recommendations, Claude should suggest sectors not in the portfolio and propose diversification targets informed by qualitative correlation causes
Execution Examples
# Basic stress test (scenario auto-detected)
python3 .../run_stress_test.py --portfolio 7203.T,AAPL,D05.SI
# Triple meltdown scenario
python3 .../run_stress_test.py --portfolio 7203.T,9984.T,6758.T --scenario triple-meltdown
# With weight specification
python3 .../run_stress_test.py --portfolio 7203.T,AAPL,D05.SI --weights 0.5,0.3,0.2
# Custom scenario
python3 .../run_stress_test.py --portfolio 7203.T,AAPL --scenario "semiconductor supply chain collapse"
Knowledge Integration Rules (KIK-466)
When get_context.py output contains the following, integrate with stress test results:
- Previous stress test (StressTest): Compare with previous scenario and result. "Previous tech crash scenario: -18% → Current: -15% (improved: lower tech weighting)"
- Concern notes: If a flagged symbol takes heavy damage in the stress test, "concern note matches → consider countermeasures"
- Investment notes: Reference hedge strategy notes if available. "Previous lesson note: insufficient JPY hedge → still weak in USD surge scenario"
1---2name: stress-test3description: Portfolio stress test. Receives a list of holdings and identifies portfolio weaknesses through shock sensitivity, scenario analysis, and causal chain analysis.4---56# Portfolio Stress Test Skill78Parse $ARGUMENTS to determine the portfolio symbol list and scenario, then run the following command.910## Execution Command1112```bash13python3 /Users/kikuchihiroyuki/stock-skills/.claude/skills/stress-test/scripts/run_stress_test.py --portfolio <symbols> [--scenario <scenario>] [--weights <weights>]14```1516## Natural Language Routing1718For natural language → skill selection, see [.claude/rules/intent-routing.md](../../rules/intent-routing.md).1920## Argument Parsing Rules2122### portfolio (symbol list — required)23Extract a comma-separated symbol list from user input. Convert space-separated input to comma-separated.2425| User Input Example | --portfolio Value |26|:-------------|:-------------|27| `7203.T,AAPL,D05.SI` | `7203.T,AAPL,D05.SI` |28| `7203.T AAPL D05.SI` | `7203.T,AAPL,D05.SI` |29| `Toyota Apple` | Convert to corresponding tickers first |3031### weights (holding ratios — optional)32Comma-separated ratio list matching the number of symbols. Defaults to equal weights (1/N per symbol).3334| User Input Example | --weights Value |35|:-------------|:------------|36| `0.5,0.3,0.2` | `0.5,0.3,0.2` |37| `50%,30%,20%` | `0.5,0.3,0.2` (convert percentages to decimals) |38| omitted | Equal weight 1/N per symbol |3940## Scenario List4142| Scenario | Description |43|:--------|:-----|44| triple-meltdown | Equities, FX, and bonds fall simultaneously. Stress across all asset classes |45| usd-jpy-surge | Sharp JPY depreciation. Rising import costs; overseas assets appreciate in JPY terms |46| us-recession | US economic downturn. Global demand contraction, risk-off |47| boj-rate-hike | Rising Japanese interest rates. Banks up, growth stocks and REITs down |48| us-china-conflict | Escalating trade friction. Supply chain disruption; hit to semiconductors and manufacturing |49| inflation-resurgence | Rising prices again. Real purchasing power declines; rate hike expectations |50| tech-crash | NASDAQ -30%. AI expectations collapse; tech stocks hit hard, flight to quality |51| jpy-appreciation | USD/JPY -20 yen. Foreign asset JPY-denominated values fall; hit to exporters |52| custom | User-specified scenario interpreted from natural language |5354## Output Format (10-Step Pipeline)5556Present results in the following structured steps.5758### Step 1: Portfolio Overview59- Symbol list (symbol, name, sector, weight)60- Total market cap (estimated)6162### Step 2: Concentration Analysis63- Sector HHI / Region HHI / Currency HHI64- Identify highest concentration axis65- Risk level judgment (diversified / somewhat concentrated / dangerously concentrated)6667### Step 3: Shock Sensitivity Scores68- Assessment of each stock's beta, financial health, and valuation resilience69- Per-symbol shock sensitivity score (0–100)7071### Step 4: Scenario Definition72- Applied scenario name and description73- Macro variable changes (assumed movements in interest rates, FX, equities)7475### Step 5: Per-Symbol Impact Estimates76- Estimated loss rate per symbol77- Application of concentration multiplier78- Portfolio-weighted impact7980### Step 6: Portfolio-Wide Impact81- Estimated portfolio-wide loss rate82- Largest loss contributor8384### Step 6b: Correlation Analysis (KIK-352)85- Cross-symbol correlation matrix (Pearson correlation, 1-year daily returns)86- High-correlation pairs detection (|r| >= 0.7)87- Factor decomposition: regress each symbol against macro variables (USD/JPY, Nikkei 225, S&P 500, crude oil, US 10-year yield)88- **LLM interpretation**: For residual correlations not explained by factor regression, use domain knowledge to infer causes (e.g., supply chain dependencies, shared customer base). Clearly separate "confirmed factors (statistical)" from "inferred factors (estimated)"8990### Step 6c: VaR (Historical Data-Based Risk Metrics) (KIK-352)91- Calculate portfolio weighted returns from 1-year daily return history92- 95% VaR / 99% VaR (daily and monthly)93- Explain the difference from the scenario analysis (tail risk) in the stress test9495### Step 7: Causal Chain Analysis96- Explanation of cascading effects when the scenario occurs97- Cross-sector propagation paths9899### Step 8: Overall Assessment + Recommended Actions (KIK-352)100- Specific risk mitigation proposals (rule-based auto-generated + Claude supplement)101- Recommendations integrating concentration, correlation, VaR, and stress test results102- Hedge candidates (symbols and sectors)103- **LLM supplement**: In addition to rule-based recommendations, Claude should suggest sectors not in the portfolio and propose diversification targets informed by qualitative correlation causes104105## Execution Examples106107```bash108# Basic stress test (scenario auto-detected)109python3 .../run_stress_test.py --portfolio 7203.T,AAPL,D05.SI110111# Triple meltdown scenario112python3 .../run_stress_test.py --portfolio 7203.T,9984.T,6758.T --scenario triple-meltdown113114# With weight specification115python3 .../run_stress_test.py --portfolio 7203.T,AAPL,D05.SI --weights 0.5,0.3,0.2116117# Custom scenario118python3 .../run_stress_test.py --portfolio 7203.T,AAPL --scenario "semiconductor supply chain collapse"119```120121## Knowledge Integration Rules (KIK-466)122123When `get_context.py` output contains the following, integrate with stress test results:124125- **Previous stress test (StressTest)**: Compare with previous scenario and result. "Previous tech crash scenario: -18% → Current: -15% (improved: lower tech weighting)"126- **Concern notes**: If a flagged symbol takes heavy damage in the stress test, "concern note matches → consider countermeasures"127- **Investment notes**: Reference hedge strategy notes if available. "Previous lesson note: insufficient JPY hedge → still weak in USD surge scenario"
erhwenkuo