@v587d/capital-generation 2.7.1 → 2.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/CHANGELOG.md +80 -0
  2. package/README.md +9 -7
  3. package/THIRD_PARTY_NOTICES.md +65 -24
  4. package/capital-config/client.js +2 -2
  5. package/capital-config/package.json +1 -1
  6. package/capital-watchlist/package.json +1 -1
  7. package/chart-ui/package.json +1 -1
  8. package/lib/web-retriever/local-fetch.d.ts +1 -1
  9. package/lib/web-retriever/local-fetch.js +1 -1
  10. package/lib/web-retriever/wind-client.d.ts +1 -1
  11. package/lib/web-retriever/wind-client.js +1 -1
  12. package/package.json +3 -1
  13. package/selected-skills/InvestSkill/UPSTREAM.md +9 -0
  14. package/selected-skills/catalog.js +200 -0
  15. package/selected-skills/china-stock-research-skills/UPSTREAM.md +2 -1
  16. package/selected-skills/investment-skills/UPSTREAM.md +2 -1
  17. package/selected-skills/peter-lynch-skill/LICENSE +21 -0
  18. package/selected-skills/peter-lynch-skill/UPSTREAM.md +72 -0
  19. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +142 -0
  20. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology.md +587 -0
  21. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/system-prompt.md +102 -0
  22. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research.md +471 -0
  23. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/disclaimer.md +2 -0
  24. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/filing-rules.md +64 -0
  25. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology.md +195 -0
  26. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/system-prompt.md +72 -0
  27. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research.md +379 -0
  28. package/selected-skills/trading-skills/LICENSE +21 -0
  29. package/selected-skills/trading-skills/UPSTREAM.md +111 -0
  30. package/selected-skills/trading-skills/skills/catalyst-map/SKILL.md +119 -0
  31. package/selected-skills/trading-skills/skills/catalyst-map/references/catalyst-framework.md +68 -0
  32. package/selected-skills/trading-skills/skills/earnings-preview/SKILL.md +124 -0
  33. package/selected-skills/trading-skills/skills/earnings-preview/references/data-providers.md +26 -0
  34. package/selected-skills/trading-skills/skills/earnings-preview/references/providers/fmp.md +49 -0
  35. package/selected-skills/trading-skills/skills/earnings-preview/references/providers/polygon.md +45 -0
  36. package/selected-skills/trading-skills/skills/earnings-preview/references/providers/tradingeconomics.md +49 -0
  37. package/selected-skills/trading-skills/skills/earnings-preview/references/relevance-ranking.md +24 -0
  38. package/selected-skills/trading-skills/skills/earnings-trade-prep/SKILL.md +134 -0
  39. package/selected-skills/trading-skills/skills/earnings-trade-prep/references/workflow-framework.md +65 -0
  40. package/selected-skills/trading-skills/skills/evidence-gap-check/SKILL.md +120 -0
  41. package/selected-skills/trading-skills/skills/evidence-gap-check/references/gap-framework.md +66 -0
  42. package/selected-skills/trading-skills/skills/execution-plan-check/SKILL.md +121 -0
  43. package/selected-skills/trading-skills/skills/execution-plan-check/references/execution-checklist.md +70 -0
  44. package/selected-skills/trading-skills/skills/journal-pattern-analyzer/SKILL.md +120 -0
  45. package/selected-skills/trading-skills/skills/journal-pattern-analyzer/references/calculation-helpers.md +16 -0
  46. package/selected-skills/trading-skills/skills/journal-pattern-analyzer/references/pattern-framework.md +74 -0
  47. package/selected-skills/trading-skills/skills/macro-event-analysis/SKILL.md +122 -0
  48. package/selected-skills/trading-skills/skills/macro-event-analysis/references/data-providers.md +23 -0
  49. package/selected-skills/trading-skills/skills/macro-event-analysis/references/interpretation-guide.md +22 -0
  50. package/selected-skills/trading-skills/skills/macro-event-analysis/references/providers/fmp.md +28 -0
  51. package/selected-skills/trading-skills/skills/macro-event-analysis/references/providers/tradingeconomics.md +40 -0
  52. package/selected-skills/trading-skills/skills/market-regime-analysis/SKILL.md +117 -0
  53. package/selected-skills/trading-skills/skills/market-regime-analysis/references/data-providers.md +26 -0
  54. package/selected-skills/trading-skills/skills/market-regime-analysis/references/providers/fmp.md +46 -0
  55. package/selected-skills/trading-skills/skills/market-regime-analysis/references/providers/polygon.md +36 -0
  56. package/selected-skills/trading-skills/skills/market-regime-analysis/references/providers/tradingeconomics.md +46 -0
  57. package/selected-skills/trading-skills/skills/market-regime-analysis/references/regime-framework.md +23 -0
  58. package/selected-skills/trading-skills/skills/portfolio-concentration/SKILL.md +119 -0
  59. package/selected-skills/trading-skills/skills/portfolio-concentration/references/concentration-framework.md +72 -0
  60. package/selected-skills/trading-skills/skills/portfolio-risk-review/SKILL.md +126 -0
  61. package/selected-skills/trading-skills/skills/portfolio-risk-review/references/workflow-framework.md +57 -0
  62. package/selected-skills/trading-skills/skills/position-management/SKILL.md +120 -0
  63. package/selected-skills/trading-skills/skills/position-management/references/management-framework.md +70 -0
  64. package/selected-skills/trading-skills/skills/position-sizing/SKILL.md +83 -0
  65. package/selected-skills/trading-skills/skills/position-sizing/assets/trade-plan-template.md +15 -0
  66. package/selected-skills/trading-skills/skills/position-sizing/references/calculation-helpers.md +13 -0
  67. package/selected-skills/trading-skills/skills/position-sizing/references/methodology.md +28 -0
  68. package/selected-skills/trading-skills/skills/post-trade-debrief/SKILL.md +99 -0
  69. package/selected-skills/trading-skills/skills/post-trade-debrief/references/workflow-framework.md +51 -0
  70. package/selected-skills/trading-skills/skills/post-trade-review/SKILL.md +82 -0
  71. package/selected-skills/trading-skills/skills/post-trade-review/references/review-rubric.md +34 -0
  72. package/selected-skills/trading-skills/skills/pre-trade-check/SKILL.md +136 -0
  73. package/selected-skills/trading-skills/skills/pre-trade-check/references/workflow-framework.md +61 -0
  74. package/selected-skills/trading-skills/skills/risk-reward-sanity-check/SKILL.md +81 -0
  75. package/selected-skills/trading-skills/skills/risk-reward-sanity-check/references/calculation-helpers.md +14 -0
  76. package/selected-skills/trading-skills/skills/risk-reward-sanity-check/references/failure-modes.md +9 -0
  77. package/selected-skills/trading-skills/skills/thesis-validation/SKILL.md +123 -0
  78. package/selected-skills/trading-skills/skills/thesis-validation/references/thesis-checklist.md +56 -0
  79. package/selected-skills/trading-skills/skills/watchlist-review/SKILL.md +119 -0
  80. package/selected-skills/trading-skills/skills/watchlist-review/references/review-framework.md +57 -0
  81. package/selected-skills/InvestSkill/ADDING-NEW-SKILLS.md +0 -546
  82. package/selected-skills/InvestSkill/CHANGELOG.md +0 -373
  83. package/selected-skills/InvestSkill/CI-CD-GUIDE.md +0 -432
  84. package/selected-skills/InvestSkill/CLAUDE.md +0 -148
  85. package/selected-skills/InvestSkill/CONTRIBUTING.md +0 -291
  86. package/selected-skills/InvestSkill/DEPLOYMENTS.md +0 -321
  87. package/selected-skills/InvestSkill/FAQ.md +0 -509
  88. package/selected-skills/InvestSkill/GEMINI.md +0 -419
  89. package/selected-skills/InvestSkill/PLATFORM-COMPATIBILITY.md +0 -529
  90. package/selected-skills/InvestSkill/README-claude-code.md +0 -435
  91. package/selected-skills/InvestSkill/README-cursor.md +0 -475
  92. package/selected-skills/InvestSkill/README-gemini.md +0 -532
  93. package/selected-skills/InvestSkill/README-ollama.md +0 -106
  94. package/selected-skills/InvestSkill/README-zh-TW.md +0 -461
  95. package/selected-skills/InvestSkill/README.md +0 -311
  96. package/selected-skills/InvestSkill/RELEASE-QUICK-REFERENCE.md +0 -230
  97. package/selected-skills/InvestSkill/RELEASE_NOTES.md +0 -121
  98. package/selected-skills/InvestSkill/SECURITY.md +0 -232
  99. package/selected-skills/InvestSkill/TODO.md +0 -28
  100. package/selected-skills/InvestSkill/package.json +0 -64
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/README.md +0 -119
  102. package/selected-skills/china-stock-research-skills/.github/ISSUE_TEMPLATE/bug_report.md +0 -35
  103. package/selected-skills/china-stock-research-skills/.github/ISSUE_TEMPLATE/skill_request.md +0 -28
  104. package/selected-skills/china-stock-research-skills/.github/PULL_REQUEST_TEMPLATE.md +0 -15
  105. package/selected-skills/china-stock-research-skills/CHANGELOG.md +0 -59
  106. package/selected-skills/china-stock-research-skills/CONTRIBUTING.md +0 -121
  107. package/selected-skills/china-stock-research-skills/GITHUB_PUBLISHING.md +0 -259
  108. package/selected-skills/china-stock-research-skills/INSTALL.md +0 -151
  109. package/selected-skills/china-stock-research-skills/PUBLISH_CHECKLIST.md +0 -165
  110. package/selected-skills/china-stock-research-skills/README.en.md +0 -209
  111. package/selected-skills/china-stock-research-skills/README.md +0 -209
  112. package/selected-skills/china-stock-research-skills/RELEASE_ASSETS.md +0 -222
  113. package/selected-skills/china-stock-research-skills/ROADMAP.md +0 -45
  114. package/selected-skills/china-stock-research-skills/SKILLS.md +0 -85
  115. package/selected-skills/china-stock-research-skills/examples/full-report-flow.md +0 -20
  116. package/selected-skills/china-stock-research-skills/examples/module-select-cases.md +0 -26
  117. package/selected-skills/china-stock-research-skills/examples/quickstart-prompts.md +0 -25
  118. package/selected-skills/investment-skills/.github/workflows/validate.yml +0 -25
  119. package/selected-skills/investment-skills/.tbd/config.yml +0 -107
  120. package/selected-skills/investment-skills/README.md +0 -253
  121. package/selected-skills/investment-skills/docs/development.md +0 -37
  122. package/selected-skills/investment-skills/docs/roadmap.md +0 -25
@@ -0,0 +1,36 @@
1
+ # Polygon
2
+
3
+ Use this path only when the user already indicated `Polygon` or chose it from the supported provider list.
4
+
5
+ Polygon is strongest here for recent price action and benchmark comparison. It does not replace macro calendar context.
6
+
7
+ ## Best endpoint for recent benchmark history
8
+
9
+ Call the official aggregate bars endpoint:
10
+
11
+ ```bash
12
+ curl "https://api.polygon.io/v2/aggs/ticker/SPY/range/1/day/2026-02-20/2026-03-06?adjusted=true&sort=asc&limit=500&apiKey=<POLYGON_API_KEY>"
13
+ ```
14
+
15
+ Repeat for `QQQ`, `IWM`, or sector ETFs only if the breadth or leadership question actually requires them.
16
+
17
+ Pull only the fields you need:
18
+
19
+ - `ticker`
20
+ - `results[].t`
21
+ - `results[].o`
22
+ - `results[].h`
23
+ - `results[].l`
24
+ - `results[].c`
25
+ - `results[].v`
26
+
27
+ ## How to use the result
28
+
29
+ - use the bar series to judge trend persistence, recent range expansion, and relative benchmark strength
30
+ - do not imply Polygon answered the macro-event question if the backdrop still depends on calendar risk
31
+ - if event timing still matters after the price check, ask whether to supplement with `FMP` or `TradingEconomics`
32
+ - disclose that Polygon supplied the market-price context
33
+
34
+ Official docs:
35
+
36
+ - [Polygon aggregate bars API](https://polygon.io/docs/rest/stocks/aggregates/custom-bars)
@@ -0,0 +1,46 @@
1
+ # TradingEconomics
2
+
3
+ Use this path only when the user already indicated `TradingEconomics` or chose it from the supported provider list.
4
+
5
+ Use it to pull only the minimum price or event context needed for the regime read.
6
+
7
+ ## Best endpoint for recent market trend
8
+
9
+ Call the official markets historical endpoint with a short benchmark basket:
10
+
11
+ ```bash
12
+ curl "https://api.tradingeconomics.com/markets/historical/spy:us,qqq:us,iwm:us?c=<TE_API_KEY>&d1=2026-02-20&d2=2026-03-06&f=json"
13
+ ```
14
+
15
+ Use this when you need a quick read on trend, relative strength, or narrowing breadth across major US equity benchmarks.
16
+
17
+ Pull only the fields you need:
18
+
19
+ - `Symbol`
20
+ - `Date`
21
+ - `Open`
22
+ - `High`
23
+ - `Low`
24
+ - `Close`
25
+
26
+ ## Optional event-backdrop check
27
+
28
+ If the regime read also needs macro timing context, use the economic calendar by country endpoint:
29
+
30
+ ```bash
31
+ curl "https://api.tradingeconomics.com/calendar/country/united%20states?c=<TE_API_KEY>&f=json"
32
+ ```
33
+
34
+ Use only the relevant upcoming events. Do not dump the entire calendar into the output.
35
+
36
+ ## How to use the result
37
+
38
+ - use the market history to judge trend persistence, volatility, and leadership concentration
39
+ - use the calendar only to confirm whether event risk is quiet, normal, or heavy
40
+ - if breadth, liquidity, or cross-asset context is still incomplete, say so directly
41
+ - disclose that TradingEconomics supplied part of the market context
42
+
43
+ Official docs:
44
+
45
+ - [TradingEconomics markets historical docs](https://docs.tradingeconomics.com/markets/historical/)
46
+ - [TradingEconomics economic calendar by country docs](https://docs.tradingeconomics.com/economic_calendar/country/)
@@ -0,0 +1,23 @@
1
+ # Regime Framework
2
+
3
+ The v1 framework uses four dimensions:
4
+
5
+ - trend
6
+ - volatility
7
+ - breadth
8
+ - event backdrop
9
+
10
+ ## Example labels
11
+
12
+ - trending-risk-on
13
+ - trending-but-fragile
14
+ - range-bound
15
+ - defensive-risk-off
16
+ - transition
17
+
18
+ ## Interpretation guidance
19
+
20
+ - Strong trend with healthy breadth and contained volatility supports trend-following tactics.
21
+ - Strong trend with narrow leadership or unstable volatility is weaker than it looks.
22
+ - Range conditions favor faster profit-taking and smaller expectations.
23
+ - Heavy event risk reduces confidence in any classification.
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: portfolio-concentration
3
+ description: Evaluate whether a portfolio, account, or planned position is too dependent on a small number of issuers, sectors, themes, or correlated exposures before the user adds or holds more risk.
4
+ ---
5
+
6
+ # Portfolio Concentration
7
+
8
+ Use this skill before adding risk when the user needs to know whether a new or existing position would make the portfolio too dependent on a small set of holdings or shared drivers.
9
+
10
+ This skill will not:
11
+
12
+ - build a full strategic asset-allocation plan
13
+ - decide tax strategy for concentrated holdings
14
+ - replace entry, stop, target, or sizing decisions
15
+
16
+ ## Role
17
+
18
+ Act like a conservative portfolio risk reviewer. Your job is to identify where diversification is weaker than it looks and where one idea may already dominate the book.
19
+
20
+ ## When to use it
21
+
22
+ Use it when the user wants to:
23
+
24
+ - check whether a new trade would overconcentrate the portfolio
25
+ - identify hidden overlap across stocks, ETFs, sectors, themes, or employer stock
26
+ - understand whether the book is too dependent on one catalyst, factor, or industry
27
+ - decide whether the portfolio can absorb additional risk before moving to `position-sizing`
28
+
29
+ ## Inputs and context
30
+
31
+ Ask for:
32
+
33
+ - current holdings with approximate weights, market values, or percentages
34
+ - whether the snapshot is the full portfolio, one account, or only the risk sleeve being reviewed
35
+ - any planned new position or add-on size
36
+ - whether any holding is employer stock, a narrow ETF, a thematic basket, or an illiquid position
37
+ - the user's objective and timeframe: tactical trading book, swing portfolio, retirement account, long-term core, and so on
38
+
39
+ Helpful but optional:
40
+
41
+ - sector, theme, or factor tags the user already tracks
42
+ - tax sensitivity if trimming a winner would be costly
43
+ - whether the user already knows certain holdings overlap
44
+
45
+ Use the user's materials first.
46
+
47
+ If the holdings snapshot is partial, say so clearly and keep the result provisional. Do not pretend a partial account view is the whole portfolio.
48
+
49
+ Work from the snapshot the user gave you. This plugin cannot read a brokerage account — the only positions it knows are the ones the user marked as held, at weights they reported themselves — so do not go and pull balances, quotes or holdings yourself: hand the exact brief (ticker, the field needed, the as-of date) to the host's own retrieval path, in a role-split host the agent that owns market data, and keep the result provisional wherever the snapshot stays partial.
50
+
51
+ ## Analysis process
52
+
53
+ 1. Reconstruct the exposure set from the user's holdings and planned change.
54
+ 2. Measure direct concentration by issuer and by top positions.
55
+ 3. Check indirect concentration from sector, theme, benchmark overlap, employer stock, or correlated assets.
56
+ 4. Flag holdings that may be harder to reduce quickly because of liquidity, tax friction, restrictions, or emotional attachment.
57
+ 5. Judge whether the proposed add would materially worsen the concentration profile.
58
+ 6. Separate concentration risk from thesis quality. A good idea can still be too large in the context of the book.
59
+ 7. End with the portfolio guardrail implication: proceed, reduce size, diversify first, or review more complete holdings before acting.
60
+
61
+ Use [references/concentration-framework.md](references/concentration-framework.md) when you need the default heuristic thresholds and overlap checklist.
62
+
63
+ ## Core Assessment Framework
64
+
65
+ Assess the portfolio on five anchors before calling it well balanced:
66
+
67
+ - `Single-Issuer Exposure`: how much of the portfolio depends on one stock or bond issuer. Example: a single stock above roughly 5% deserves review; above roughly 10% is often already an elevated concentration case for many investors.
68
+ - `Correlated Cluster Exposure`: how much of the book depends on the same sector, theme, geography, factor, or benchmark leaders. Example: owning NVDA, SMH, and a cloud or AI theme sleeve may be more concentrated than the ticker count suggests.
69
+ - `Employment Or Identity Link`: whether the same company or theme affects both portfolio value and outside life circumstances. Example: employer stock can create a double hit to income and net worth.
70
+ - `Exit Flexibility`: how easily the user could reduce the exposure if conditions change. Example: illiquid securities, narrow products, or restricted stock create worse concentration risk than a liquid broad ETF at the same weight.
71
+ - `Snapshot Completeness`: whether the analysis saw enough of the user's holdings to judge true diversification. Example: a single brokerage account may understate bond exposure, international exposure, or offsetting holdings elsewhere.
72
+
73
+ Use the anchors to classify:
74
+
75
+ - `acceptable`: no position or correlated cluster appears dominant relative to the stated objective, and the planned add does not materially distort the book
76
+ - `elevated`: one or more positions or clusters deserve active monitoring or a smaller add because the portfolio is becoming too dependent on a limited set of drivers
77
+ - `too concentrated`: issuer, cluster, employer-stock, or liquidity risk is strong enough that adding exposure or holding as-is deserves a rethink before trade construction proceeds
78
+
79
+ ## Evidence That Would Invalidate This Analysis
80
+
81
+ - the holdings snapshot was incomplete or stale enough to hide meaningful offsetting or overlapping exposures
82
+ - the planned add size changes materially
83
+ - a holding's sector, theme, or benchmark role was misclassified
84
+ - tax, lock-up, or liquidity constraints were stronger or weaker than described
85
+ - the user's objective changes from tactical trading capital to long-horizon core capital, or the reverse
86
+
87
+ ## Output structure
88
+
89
+ Prefer this output order:
90
+
91
+ 1. `Concentration Summary`
92
+ 2. `Top Exposure Risks`
93
+ 3. `Overlap And Correlation Review`
94
+ 4. `Portfolio Guardrail`
95
+ 5. `What Changes The Verdict`
96
+ 6. `Next Skill`
97
+
98
+ Always include:
99
+
100
+ - whether the snapshot was full or partial
101
+ - the main issuer or cluster concentration
102
+ - any hidden overlap across stocks, ETFs, sectors, or themes
103
+ - whether the planned add worsens concentration materially
104
+ - any special risk from employer stock, narrow products, or illiquid holdings
105
+ - whether the user should move next to `position-sizing`, reduce exposure first, or review a fuller portfolio snapshot
106
+
107
+ A skill named above is an option for the user, not a step this role can take: only the skills the user switched on exist in this session, and the ones this plugin deliberately does not offer — placing orders, setting position size — are not reachable at all. Say what you would check next and let the user decide.
108
+
109
+ ## Best practices
110
+
111
+ - do not equate more tickers with true diversification
112
+ - do not ignore ETF or fund overlap with individual positions
113
+ - do not treat employer stock like an ordinary holding
114
+ - do not recommend a larger position just because the thesis is attractive
115
+
116
+ ## Usage examples
117
+
118
+ - "Use `portfolio-concentration` on this book before I add more semis: NVDA 8%, SMH 10%, QQQ 12%, cash 20%, the rest broad ETFs."
119
+ - "Use `portfolio-concentration` on my retirement account and tell me whether my employer stock and AI funds have made the portfolio more concentrated than it looks."
@@ -0,0 +1,72 @@
1
+ # Concentration Framework
2
+
3
+ Use this framework to judge whether a portfolio is less diversified than the raw ticker count suggests.
4
+
5
+ ## What concentration risk actually means
6
+
7
+ Concentration risk is not only "one giant stock position."
8
+
9
+ It can also come from:
10
+
11
+ - multiple holdings tied to the same issuer
12
+ - sector overlap
13
+ - thematic overlap
14
+ - benchmark overlap
15
+ - employer stock
16
+ - illiquid positions that cannot be reduced easily
17
+ - partial portfolio views that hide true exposures
18
+
19
+ ## Source-informed heuristics
20
+
21
+ These are practical review thresholds, not universal laws:
22
+
23
+ - A single position at roughly `5%` of total portfolio value deserves review.
24
+ - A single issuer above roughly `10%` is often already an elevated concentration case for many investors.
25
+ - Employer stock above roughly `10-20%` is a notable overconcentration risk because income and portfolio value may depend on the same company.
26
+ - Two or three concentrated single-name positions can create concentration risk even if no single holding looks extreme by itself.
27
+
28
+ These heuristics are informed by retail-investor guidance and portfolio tools from FINRA, Fidelity, and Schwab. Use them as prompts for review, not mechanical rules.
29
+
30
+ ## Direct vs indirect concentration
31
+
32
+ Direct concentration:
33
+
34
+ - one stock
35
+ - one bond issuer
36
+ - one narrow ETF
37
+
38
+ Indirect concentration:
39
+
40
+ - individual semiconductor names plus a semiconductor ETF
41
+ - multiple AI or cloud names with the same demand driver
42
+ - broad indexes that already have large weights in the same mega-cap holdings
43
+ - company stock plus compensation, restricted stock, or career exposure to the same issuer
44
+
45
+ ## What to look for
46
+
47
+ Ask:
48
+
49
+ - What are the top three positions?
50
+ - What are the top three correlated clusters?
51
+ - If one thesis fails, how many holdings fail with it?
52
+ - Could the user reduce the exposure quickly?
53
+ - Is this the full portfolio or just one sleeve?
54
+
55
+ ## Typical caution cases
56
+
57
+ - employer stock paired with salary dependence
58
+ - narrow sector ETFs layered on top of the same underlying single names
59
+ - thematic baskets that look diversified by label but share the same catalyst chain
60
+ - portfolios tied closely to cap-weighted indexes during periods of heavy mega-cap concentration
61
+ - illiquid or tax-constrained winners that grew into oversized positions
62
+
63
+ ## Boundaries
64
+
65
+ This framework does not decide:
66
+
67
+ - whether the thesis is valid
68
+ - where to enter
69
+ - where the stop belongs
70
+ - how large the position should be
71
+
72
+ It only answers whether the portfolio is already too dependent on a small set of exposures.
@@ -0,0 +1,126 @@
1
+ ---
2
+ name: portfolio-risk-review
3
+ description: Orchestrate a whole-book risk review by checking concentration, correlated exposure, catalyst clustering, market-context sensitivity, and live-position fragility before the user adds, holds, or reduces portfolio risk.
4
+ ---
5
+
6
+ # Portfolio Risk Review
7
+
8
+ Use this workflow skill when the user wants a portfolio-level answer to the question, "Where is my real risk right now?" rather than a single-position analysis.
9
+
10
+ This workflow will not:
11
+
12
+ - build a long-term strategic financial plan
13
+ - replace tax, legal, or retirement-planning advice
14
+ - assume a portfolio is safe just because no single holding looks extreme in isolation
15
+
16
+ ## Role
17
+
18
+ Act like a portfolio risk reviewer. Your job is to identify where the book is actually exposed, which risks are clustered, and what needs attention before the user adds, holds, or reduces risk.
19
+
20
+ ## When to use it
21
+
22
+ Use it when the user wants to:
23
+
24
+ - review portfolio risk before adding a new position
25
+ - understand where concentration or overlap is hiding
26
+ - assess whether upcoming catalysts create too much clustered exposure
27
+ - know whether the current book needs trimming, hedging, smaller adds, or closer monitoring
28
+
29
+ ## Inputs and context
30
+
31
+ Ask for:
32
+
33
+ - the portfolio or account snapshot, including approximate weights or position sizes
34
+ - whether the snapshot is the full portfolio, one account, or only the active risk sleeve
35
+ - any planned new add or reduction
36
+ - upcoming catalysts the user already knows about
37
+ - whether the focus is tactical trading capital, swing capital, or longer-term investing capital
38
+
39
+ Helpful but optional:
40
+
41
+ - sector, theme, or factor tags
42
+ - current regime view or macro concern
43
+ - which positions are already under pressure or near key catalysts
44
+ - any known liquidity or execution constraints
45
+
46
+ Use the user's materials first.
47
+
48
+ If the snapshot is partial, say so clearly and keep the result provisional.
49
+
50
+ ## Workflow routing
51
+
52
+ Use the smallest useful chain:
53
+
54
+ 1. Run `portfolio-concentration` to identify direct and indirect concentration.
55
+ 2. If catalyst clustering matters, run `catalyst-map`.
56
+ 3. If broad market context matters, run `market-regime-analysis`.
57
+ 4. If a major macro calendar is relevant to the portfolio, run `macro-event-analysis`.
58
+ 5. If one or more open positions are under pressure, run `position-management` on the critical positions.
59
+ 6. If the user is considering a new add, run `pre-trade-check` or the specific construction skills only after the portfolio-level risk picture is clear.
60
+
61
+ Stop the workflow when the book is already too concentrated or too catalyst-heavy for the user's stated objective.
62
+
63
+ ## Decision logic
64
+
65
+ Classify the result as:
66
+
67
+ - `portfolio risk acceptable`: the book appears aligned with the user's objective and no immediate portfolio-level change is necessary
68
+ - `portfolio risk elevated`: the book is still manageable, but concentration, overlap, or catalyst clustering needs active monitoring or smaller adds
69
+ - `portfolio risk too high`: the book is too dependent on a limited set of exposures, events, or fragile positions to justify adding risk without changes
70
+
71
+ ## Output structure
72
+
73
+ Prefer this output order:
74
+
75
+ 1. `Portfolio Risk Verdict`
76
+ 2. `Checks Run`
77
+ 3. `Main Risk Sources`
78
+ 4. `Catalyst And Regime Pressure`
79
+ 5. `What To Reduce, Watch, Or Avoid Adding`
80
+ 6. `Updated Portfolio Context`
81
+ 7. `Next Skill Or Action`
82
+
83
+ Always include:
84
+
85
+ - whether the snapshot was full or partial
86
+ - the main risk sources in the current book
87
+ - where exposures overlap or cluster
88
+ - whether upcoming catalysts or macro conditions increase portfolio fragility
89
+ - whether the right action is hold, trim, avoid adding, or review specific positions more closely
90
+ - a compact updated portfolio context block when enough information exists
91
+
92
+ ## Updated Portfolio Context
93
+
94
+ When enough context exists, carry forward a compact block like this:
95
+
96
+ ```markdown
97
+ ## Portfolio Context
98
+
99
+ - objective:
100
+ - snapshot_scope:
101
+ - top_exposures:
102
+ - overlap_clusters:
103
+ - key_catalysts:
104
+ - regime_pressure:
105
+ - fragile_positions:
106
+ - planned_add:
107
+ - portfolio_constraints:
108
+ - risk_summary:
109
+ - open_questions:
110
+ - assumptions:
111
+ - next_recommended_skill:
112
+ ```
113
+
114
+ Only populate the fields supported by the checks that actually ran.
115
+
116
+ ## Best practices
117
+
118
+ - do not treat issuer count as diversification by itself
119
+ - do not ignore shared catalyst risk across several names
120
+ - do not review a partial snapshot as if it were the whole book
121
+ - do not continue into a new trade workflow before the portfolio-level blocker is explicit
122
+
123
+ ## Usage examples
124
+
125
+ - "Use `portfolio-risk-review` on my current book before I add more semis."
126
+ - "Use `portfolio-risk-review` on this account for the next two weeks and tell me where the real risk is concentrated."
@@ -0,0 +1,57 @@
1
+ # Portfolio Risk Review Framework
2
+
3
+ Use this framework to decide whether portfolio-level risk is acceptable before adding or maintaining more exposure.
4
+
5
+ ## Core question
6
+
7
+ The question is not only:
8
+
9
+ - "What is my biggest position?"
10
+
11
+ The real questions are:
12
+
13
+ - Where are my exposures clustered?
14
+ - Which catalysts matter to the portfolio as a whole?
15
+ - Which positions are fragile right now?
16
+ - Is the current book aligned with my objective and timeframe?
17
+
18
+ ## Typical routing
19
+
20
+ Start with:
21
+
22
+ - `portfolio-concentration`
23
+
24
+ Add as needed:
25
+
26
+ - `catalyst-map` when several positions share event risk
27
+ - `market-regime-analysis` when broad tape conditions matter
28
+ - `macro-event-analysis` when the macro calendar can pressure the whole book
29
+ - `position-management` when one or more live positions are under pressure
30
+
31
+ If the user still wants a new trade after the review:
32
+
33
+ - `pre-trade-check`
34
+
35
+ ## Stop conditions
36
+
37
+ Stop when:
38
+
39
+ - concentration is already too high
40
+ - several positions share the same catalyst cluster
41
+ - the macro or regime backdrop makes the current book too fragile
42
+ - the portfolio snapshot is too incomplete to review honestly
43
+
44
+ ## Wrapper discipline
45
+
46
+ The workflow should:
47
+
48
+ - surface the biggest risk sources fast
49
+ - separate portfolio-level risk from single-name conviction
50
+ - avoid pretending the portfolio is diversified when the drivers are the same
51
+ - return one clear next portfolio action
52
+
53
+ ## Boundaries
54
+
55
+ This workflow does not perform full financial planning.
56
+
57
+ It only reviews current portfolio risk and what should happen next.
@@ -0,0 +1,120 @@
1
+ ---
2
+ name: position-management
3
+ description: Review an open position and decide whether to hold, trim, tighten risk, close, or wait by comparing current behavior against the original thesis, invalidation logic, catalyst calendar, and execution constraints.
4
+ ---
5
+
6
+ # Position Management
7
+
8
+ Use this skill after a position is open when the user needs a disciplined decision about holding, trimming, tightening risk, or exiting without drifting into improvisation.
9
+
10
+ This skill will not:
11
+
12
+ - justify staying in a broken trade because the user wants it to work
13
+ - replace pre-trade sizing or portfolio-concentration review
14
+ - guarantee that stop adjustments or trailing logic will lock in a specific outcome
15
+
16
+ ## Role
17
+
18
+ Act like a disciplined live-risk manager. Your job is to compare the open position against the original plan, current market behavior, and upcoming catalysts, then recommend the next management decision clearly.
19
+
20
+ ## When to use it
21
+
22
+ Use it when the user wants to:
23
+
24
+ - decide whether to hold, trim, tighten risk, or exit an open position
25
+ - manage a winner without turning it into a round trip
26
+ - handle a loser without widening risk impulsively
27
+ - decide whether holding through earnings, macro releases, or other catalysts still makes sense
28
+
29
+ ## Inputs and context
30
+
31
+ Ask for:
32
+
33
+ - instrument and direction
34
+ - original thesis, timeframe, entry, stop, target, and size
35
+ - current price behavior or status: near target, stalling, breaking down, gapping, and so on
36
+ - current stop logic or trailing logic
37
+ - any upcoming catalyst or event risk
38
+ - whether the user is trying to protect gains, reduce loss, hold through a catalyst, or simply avoid emotional decision-making
39
+
40
+ Helpful but optional:
41
+
42
+ - unrealized PnL or R multiple
43
+ - partial exits already taken
44
+ - whether the position sits in a concentrated portfolio or highly correlated cluster
45
+ - order or liquidity constraints that affect exits
46
+
47
+ Use the user's materials first.
48
+
49
+ If the original plan is missing, say that clearly and manage the position provisionally rather than inventing a clean prior plan.
50
+
51
+ Do not fetch live data unless the user explicitly asks to pair this skill with another market-context or event-risk skill.
52
+
53
+ ## Analysis process
54
+
55
+ 1. Reconstruct the original plan and the current position status.
56
+ 2. Compare current behavior against the thesis and invalidation logic.
57
+ 3. Separate normal noise from evidence that the trade or investment is weakening.
58
+ 4. Evaluate whether an upcoming catalyst changes the holding decision materially.
59
+ 5. Check whether the current stop, trailing logic, or target handling is still coherent.
60
+ 6. Distinguish between thesis-based management and emotion-based improvisation.
61
+ 7. End with one clear next action: hold, trim, tighten risk, close, or wait for a defined condition.
62
+
63
+ Use [references/management-framework.md](references/management-framework.md) when you need the default checklist for open-risk decisions, trailing logic, and catalyst-aware management.
64
+
65
+ ## Core Assessment Framework
66
+
67
+ Assess the open position on five anchors before recommending a change:
68
+
69
+ - `Thesis Integrity`: whether the original reason for holding still looks intact. Example: a breakout that loses leadership and closes back into the prior range has weaker thesis integrity than one consolidating above the breakout area.
70
+ - `Reward Realization`: whether the trade has already traveled enough that the management problem changes from "is the idea valid?" to "how do I avoid giving too much back?" Example: a position near target may justify different management than a new entry still proving itself.
71
+ - `Risk Drift`: whether the user has widened risk, delayed exits, or let the position drift away from the original plan. Example: moving the stop wider after entry without a new thesis is usually risk drift, not strategy.
72
+ - `Catalyst Exposure`: whether earnings, macro releases, or other scheduled events make the current holding plan materially more fragile. Example: a swing long near target ahead of earnings may deserve a different decision than the same setup in a quiet calendar.
73
+ - `Exit Practicality`: whether liquidity, spread, session timing, or order constraints affect the ability to trim or exit cleanly. Example: a thin option or extended-hours position may require more conservative management.
74
+
75
+ Use the anchors to classify:
76
+
77
+ - `hold with plan intact`: the position still fits the original logic and current management rules
78
+ - `manage actively`: the thesis may still be alive, but trimming, tightening risk, or updating the hold plan is warranted
79
+ - `exit or reduce decisively`: the thesis, catalyst profile, or risk discipline has degraded enough that passive holding is no longer defensible
80
+
81
+ ## Evidence That Would Invalidate This Analysis
82
+
83
+ - the original plan was remembered incorrectly or new plan details appear
84
+ - the catalyst timing changes materially
85
+ - the user's timeframe changes from tactical trade to longer-term hold, or the reverse
86
+ - the current position size or partial exits differ from what was described
87
+ - the session, liquidity, or execution conditions change enough to alter the practicality of the suggested action
88
+
89
+ ## Output structure
90
+
91
+ Prefer this output order:
92
+
93
+ 1. `Management Summary`
94
+ 2. `Original Plan Versus Now`
95
+ 3. `Thesis And Risk Review`
96
+ 4. `Catalyst Decision`
97
+ 5. `Best Next Action`
98
+ 6. `What Would Change That Decision`
99
+ 7. `Next Skill`
100
+
101
+ Always include:
102
+
103
+ - whether the original thesis still looks intact
104
+ - whether the current stop or trailing logic is coherent
105
+ - whether upcoming catalysts change the hold decision
106
+ - the clearest next action: hold, trim, tighten risk, close, or wait
107
+ - what specific condition would change that action
108
+ - whether the next step is `post-trade-review`, `macro-event-analysis`, `earnings-preview`, or no additional skill yet
109
+
110
+ ## Best practices
111
+
112
+ - do not widen risk casually after entry
113
+ - do not manage only from unrealized PnL
114
+ - do not hold through a catalyst by inertia
115
+ - do not tighten stops so aggressively that the plan stops matching the thesis
116
+
117
+ ## Usage examples
118
+
119
+ - "Use `position-management` on this NVDA swing long. I am up about 1.8R, earnings are next week, and I need to decide whether to trim or hold."
120
+ - "Use `position-management` on this losing EURUSD short. The thesis is not fully broken, but price is stalling and I do not want to widen the stop emotionally."
@@ -0,0 +1,70 @@
1
+ # Position Management Framework
2
+
3
+ Use this framework to manage an open position without drifting into improvisation.
4
+
5
+ ## Core question
6
+
7
+ The question is not only:
8
+
9
+ - "Am I up or down?"
10
+
11
+ The real questions are:
12
+
13
+ - Is the thesis still intact?
14
+ - Has the risk profile changed?
15
+ - Does a catalyst change the holding decision?
16
+ - What is the next clean action?
17
+
18
+ ## Common management actions
19
+
20
+ - `hold`: thesis and management plan still fit
21
+ - `trim`: realize part of the gain or reduce event exposure
22
+ - `tighten risk`: reduce giveback or adapt to weakening conditions
23
+ - `close`: thesis broken, catalyst risk too high, or discipline deteriorating
24
+ - `wait for condition`: no change yet, but only if the condition is explicit
25
+
26
+ ## Typical mistakes
27
+
28
+ - widening stops after entry without a new thesis
29
+ - refusing to trim because of fear of missing out
30
+ - tightening stops purely because unrealized PnL feels uncomfortable
31
+ - holding through earnings or macro catalysts by default
32
+ - treating a temporary bounce as proof the thesis is restored
33
+
34
+ ## Winners versus losers
35
+
36
+ For winners:
37
+
38
+ - ask whether the position has already delivered enough to justify different management
39
+ - protect against turning a good trade into a round trip
40
+ - avoid trimming only because of emotion if the thesis and trend are still strong
41
+
42
+ For losers:
43
+
44
+ - check whether the invalidation condition is already near or already hit
45
+ - do not widen risk casually
46
+ - separate temporary noise from genuine thesis deterioration
47
+
48
+ ## Catalyst-aware management
49
+
50
+ Upcoming catalysts can change the right action even if price has not moved much yet.
51
+
52
+ Review:
53
+
54
+ - earnings dates
55
+ - macro releases
56
+ - central-bank events
57
+ - policy decisions
58
+ - company-specific milestones
59
+
60
+ If the event can materially compress the decision window, management should become more explicit, not less.
61
+
62
+ ## Boundaries
63
+
64
+ This framework does not decide:
65
+
66
+ - whether the original entry was good
67
+ - how much size should have been taken initially
68
+ - whether the portfolio was too concentrated before entry
69
+
70
+ It only helps manage the position that already exists.