@v587d/capital-generation 2.7.12 → 2.8.1

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 (157) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +10 -6
  3. package/THIRD_PARTY_NOTICES.md +6 -1
  4. package/chart-ui/package.json +1 -1
  5. package/config/index.js +1 -0
  6. package/config/package.json +1 -1
  7. package/lib/agents/bash-guard.d.ts +22 -17
  8. package/lib/agents/bash-guard.js +32 -28
  9. package/lib/agents/root-tool-policy.d.ts +29 -3
  10. package/lib/agents/root-tool-policy.js +100 -14
  11. package/lib/data-collector/dataset-tools.js +9 -0
  12. package/lib/data-collector/tools.js +17 -5
  13. package/lib/index.d.ts +4 -0
  14. package/lib/index.js +27 -8
  15. package/lib/sources/ftshare-rest.d.ts +54 -0
  16. package/lib/sources/ftshare-rest.js +2363 -0
  17. package/lib/time/tools.js +24 -0
  18. package/lib/web-retriever/local-fetch.d.ts +1 -1
  19. package/lib/web-retriever/local-fetch.js +1 -1
  20. package/lib/web-retriever/wind-client.d.ts +1 -1
  21. package/lib/web-retriever/wind-client.js +1 -1
  22. package/package.json +1 -1
  23. package/preset/capital-generation/README.md +22 -15
  24. package/preset/capital-generation/agent.patch.yml +14 -1
  25. package/preset/capital-generation/skills/capital-data-protocol/SKILL.md +4 -1
  26. package/selected-skills/InvestSkill/UPSTREAM.md +17 -0
  27. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +10 -296
  28. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md +130 -0
  29. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md +129 -0
  30. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/12-language-mode.md +60 -0
  31. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +5 -3
  32. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +10 -284
  33. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/10-persona.md +113 -0
  34. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/11-section-c-company-specific.md +108 -0
  35. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/12-section-f-90-day.md +85 -0
  36. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +11 -433
  37. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/10-overview.md +82 -0
  38. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/11-porter-s-five-forces.md +137 -0
  39. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/12-innovation-disruption-assessment.md +112 -0
  40. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/13-input-formats.md +130 -0
  41. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +12 -639
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/10-analysis-framework.md +138 -0
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/11-dividend-history-and-reliability.md +131 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/12-share-buyback-analysis.md +125 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/13-fcf-deployment-scorecard.md +133 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/14-output.md +149 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +10 -411
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/10-analysis-framework.md +194 -0
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md +196 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/12-thesis-invalidation.md +43 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +11 -234
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/10-overview.md +86 -0
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/11-phase-4-the-implied.md +60 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/12-output-format.md +83 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/13-standard-signal-output.md +34 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +10 -304
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/10-key-economic-indicators.md +98 -0
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/11-credit-market-indicators.md +114 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/12-recession-probability-scoring.md +114 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +11 -236
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/10-overview.md +83 -0
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/11-phase-5-overlap-with.md +69 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/12-output-format.md +79 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/13-standard-signal-output.md +34 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +11 -243
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md +61 -0
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md +54 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/12-phase-5-consistency.md +90 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md +68 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +11 -499
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md +143 -0
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/11-phase-3-financial-statement.md +167 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/12-phase-6-management-tone.md +176 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/13-thesis-invalidation.md +43 -0
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +10 -291
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md +117 -0
  77. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/11-step-3-position-locator.md +112 -0
  78. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md +84 -0
  79. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +10 -457
  80. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/10-analysis-framework.md +185 -0
  81. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md +175 -0
  82. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md +120 -0
  83. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +11 -503
  84. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/10-analysis-framework.md +132 -0
  85. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md +166 -0
  86. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md +192 -0
  87. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/13-thesis-invalidation.md +43 -0
  88. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +11 -264
  89. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/10-overview.md +63 -0
  90. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/11-phase-2-explanation-card.md +108 -0
  91. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/12-output-format.md +88 -0
  92. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/13-standard-signal-output.md +34 -0
  93. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +11 -448
  94. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/10-analysis-framework.md +109 -0
  95. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/11-implied-volatility-iv-analysis.md +102 -0
  96. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/12-earnings-play-analysis.md +109 -0
  97. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/13-data-sources.md +159 -0
  98. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +11 -435
  99. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/10-phase-1-portfolio-snapshot.md +124 -0
  100. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/11-phase-6-correlation-diversification.md +124 -0
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/12-phase-9-rebalancing-decision.md +153 -0
  102. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/13-data-verification.md +62 -0
  103. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +11 -372
  104. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/10-overview.md +102 -0
  105. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/11-phase-3-the-trim.md +88 -0
  106. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/12-phase-6-the-thesis.md +105 -0
  107. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/13-input-formats.md +105 -0
  108. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +10 -250
  109. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/10-overview.md +92 -0
  110. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/11-phase-4-correlation-spike.md +116 -0
  111. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/12-notes.md +65 -0
  112. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +11 -381
  113. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/10-sector-overview.md +123 -0
  114. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/11-sector-correlation-matrix.md +90 -0
  115. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/12-peer-benchmarking-within-sector.md +92 -0
  116. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/13-consumer-staples.md +105 -0
  117. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +10 -352
  118. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/10-analysis-framework.md +110 -0
  119. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/11-bearish-thesis-evaluation.md +118 -0
  120. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/12-data-sources.md +148 -0
  121. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +16 -603
  122. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/10-analysis-components.md +122 -0
  123. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/11-dupont-decomposition.md +121 -0
  124. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/12-quality-scoring-framework.md +115 -0
  125. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/13-dcf-framework.md +113 -0
  126. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/14-analyst-consensus-tracking.md +127 -0
  127. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/15-thesis-invalidation.md +43 -0
  128. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +5 -3
  129. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +12 -595
  130. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/10-overview.md +133 -0
  131. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/11-method-2-comparable-company.md +127 -0
  132. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/12-football-field-summary-valuation.md +140 -0
  133. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/13-terminal-value-two-methods.md +121 -0
  134. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/14-when-dcf-is.md +110 -0
  135. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +12 -304
  136. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/10-overview.md +73 -0
  137. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/11-phase-3-dividends-qualified.md +67 -0
  138. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/12-framework-non-us-module.md +61 -0
  139. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/13-scoring-tax-efficiency-score.md +83 -0
  140. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/14-thesis-invalidation.md +55 -0
  141. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +16 -612
  142. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/10-chart-pattern-analysis.md +172 -0
  143. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/11-chart-visualization-support.md +181 -0
  144. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/12-multi-timeframe-analysis-mtf.md +95 -0
  145. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/13-advanced-indicators-ichimoku-cloud.md +61 -0
  146. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/14-options-flow-integration.md +95 -0
  147. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/15-thesis-invalidation.md +45 -0
  148. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +10 -274
  149. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/10-overview.md +94 -0
  150. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/11-phase-5-the-pre.md +113 -0
  151. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/12-example.md +90 -0
  152. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +5 -3
  153. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +5 -3
  154. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +5 -3
  155. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
  156. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +5 -3
  157. package/watchlist/package.json +1 -1
@@ -0,0 +1,130 @@
1
+ # 🔎 Retrieving the Filing — the Keyless EDGAR Path
2
+
3
+ Part 1 of 3 for `10k-digest` — 🔎 Retrieving the Filing — the Keyless EDGAR Path; How to Use; Output Document Structure
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## 🔎 Retrieving the Filing — the Keyless EDGAR Path
7
+
8
+ This skill fetches nothing by itself. When the user gives only a ticker, obtain the 10-K in one of three ways and record which one in the `Data & Sources` header:
9
+
10
+ **A. Retrieval through the host (the normal path)** → `Retrieval: delegated retrieval`. In a role-split host, delegate the fetch to the agent that owns web retrieval — this step never searches from the analysis role itself. Every step is free and needs no API key:
11
+
12
+ 1. **Ticker → CIK** — `https://www.sec.gov/files/company_tickers.json`: find the entry whose `ticker` matches (write `BRK-B` for `BRK.B`) and zero-pad its `cik_str` to 10 digits.
13
+ 2. **Filings index** — `https://data.sec.gov/submissions/CIK##########.json`: inside `filings.recent` the arrays `form`, `filingDate`, `reportDate`, `accessionNumber` and `primaryDocument` are aligned by index. Take the newest row whose `form` is `10-K` (foreign private issuers file `20-F` instead; a `10-K/A` is an amendment). The top-level `fiscalYearEnd` is `MMDD`.
14
+ 3. **The document** — `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>`: the complete filing as HTML (inline XBRL). The filing's index page is the same folder plus `<accessionNumber>-index.htm`; cite that URL and the accession number in the References.
15
+ 4. **Structured statement data (optional)** — `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`: every US-GAAP fact the company has tagged, by concept and period. Use it to confirm the figures read from Item 8.
16
+ 5. **Full-text search (optional)** — `https://www.sec.gov/edgar/search/#/q=%22<phrase>%22&forms=10-K` when a filing has to be located by phrase rather than ticker.
17
+
18
+ Send a `User-Agent` header that identifies the requester (the SEC requires it, e.g. `Name email@example.com`) and stay under 10 requests per second. Never substitute a summary site for the filing itself.
19
+
20
+ **B. Only if the host has no retrieval path at all** → `Retrieval: pasted by user`. Ask the user for the sections needed. The repository's own fetch helpers are optional, keyless, and live outside this plugin — they are never run from here.
21
+
22
+ **C. Neither** → show the ⚠️ *Source unavailable* warning and digest only what the user provided. What is absent stays absent: no accession number, figure or date is filled in from memory.
23
+
24
+ ---
25
+
26
+ ## How to Use
27
+
28
+ ```
29
+ # Analyze by ticker (retrieves the latest 10-K via the EDGAR path above, or asks you to paste it)
30
+ /10k-digest AAPL
31
+
32
+ # Paste 10-K text directly
33
+ /10k-digest [paste 10-K sections here]
34
+
35
+ # Specify fiscal year
36
+ /10k-digest MSFT FY2024
37
+
38
+ # Output in Traditional Chinese
39
+ /10k-digest NVDA --lang zh-TW
40
+
41
+ # Save output to file
42
+ /10k-digest GOOGL --output googl-10k-digest.md
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Output Document Structure
48
+
49
+ The skill produces a single markdown document with the following sections in order.
50
+
51
+ ---
52
+
53
+ ### 1. Cover Block
54
+
55
+ ```
56
+ # [Company Name] ([TICKER]) — 10-K Digest
57
+ **Fiscal Year:** [FY20XX ending MM/DD/YYYY]
58
+ **Filed:** [Filing date]
59
+ **Source:** SEC EDGAR — [Direct URL to filing]
60
+ **Prepared:** [Today's date]
61
+ **Language:** English | 繁體中文
62
+ ```
63
+
64
+ ---
65
+
66
+ ### 2. Abstract
67
+
68
+ A 3–5 sentence executive summary of the entire 10-K. Cover:
69
+ - What the company does (core business in one sentence)
70
+ - Year-over-year financial performance headline (revenue, profit, FCF)
71
+ - The single most important strategic development disclosed in this filing
72
+ - The most material risk disclosed
73
+ - Overall filing tone (transparent / cautious / optimistic)
74
+
75
+ ---
76
+
77
+ ### 3. Section Summaries
78
+
79
+ Summarize each major 10-K section. For each section, write 2–4 sentences capturing the substance — not just restating headings.
80
+
81
+ #### 3.1 Business Overview (Item 1)
82
+ - Core products/services and revenue model
83
+ - Key markets and customer segments
84
+ - Significant changes to business described in this filing (new products, acquisitions, divestitures)
85
+
86
+ #### 3.2 Risk Factors (Item 1A)
87
+ - Total number of risk factors disclosed
88
+ - Top 3 risks by disclosure prominence (listed first, given most space, or new this year)
89
+ - Any risks added or removed vs. prior filing (state "N/A if prior not available")
90
+ - One-line assessment: are risks standard boilerplate or specific and material?
91
+
92
+ #### 3.3 Selected Financial Data / Properties (Items 1B–2)
93
+ - Key quantitative highlights from Selected Financial Data if present
94
+ - Material properties or facilities disclosed
95
+
96
+ #### 3.4 Management's Discussion & Analysis — MD&A (Item 7)
97
+ - Revenue: total and YoY growth; organic vs. inorganic split if stated
98
+ - Gross margin and operating margin trend
99
+ - Management's stated explanation for performance changes
100
+ - Forward-looking statements: what management guided or projected
101
+ - Liquidity summary: cash position, debt level, upcoming maturities
102
+
103
+ #### 3.5 Financial Statements (Items 8)
104
+ - Revenue, net income, EPS (GAAP) — current year vs. prior year
105
+ - Operating cash flow and free cash flow (OCF minus capex)
106
+ - Total assets, total debt, shareholders' equity
107
+ - Auditor name and opinion type (unqualified / qualified / adverse)
108
+ - Any restatements or material changes in accounting policy noted
109
+
110
+ #### 3.6 Quantitative Disclosures about Market Risk (Item 7A)
111
+ - Primary market risks disclosed (interest rate, FX, commodity)
112
+ - Sensitivity disclosures if provided (e.g., "1% rate rise = $X impact")
113
+
114
+ #### 3.7 Controls and Procedures (Item 9A)
115
+ - Management's conclusion on effectiveness of internal controls
116
+ - Any material weaknesses or significant deficiencies disclosed
117
+
118
+ #### 3.8 Legal Proceedings (Item 3)
119
+ - Active material litigation or regulatory matters
120
+ - Estimated financial exposure if disclosed
121
+
122
+ #### 3.9 Executive Compensation & Governance (Items 10–13, from Proxy if incorporated)
123
+ - CEO/CFO compensation summary
124
+ - Board composition notes (independence, tenure)
125
+ - Any significant governance changes
126
+
127
+ ---
128
+
129
+
130
+ This section is not finished here: `Output Document Structure` continues in `references/11-key-metrics-table.md`.
@@ -0,0 +1,129 @@
1
+ # Output Document Structure(continued)
2
+
3
+ Part 2 of 3 for `10k-digest` — Output Document Structure; References
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ### 4. Key Metrics Table
7
+
8
+ Provide a concise metrics table drawn directly from the financial statements. Use exact figures from the filing; do not estimate.
9
+
10
+ ```
11
+ | Metric | Current FY | Prior FY | YoY Change |
12
+ |---------------------------|-----------------|-----------------|------------|
13
+ | Revenue | $X.XX B | $X.XX B | +X.X% |
14
+ | Gross Profit | $X.XX B | $X.XX B | +X.X% |
15
+ | Gross Margin % | XX.X% | XX.X% | +X bps |
16
+ | Operating Income | $X.XX B | $X.XX B | |
17
+ | Operating Margin % | XX.X% | XX.X% | |
18
+ | Net Income (GAAP) | $X.XX B | $X.XX B | |
19
+ | EPS Diluted (GAAP) | $X.XX | $X.XX | |
20
+ | Operating Cash Flow | $X.XX B | $X.XX B | |
21
+ | Capital Expenditures | $X.XX B | $X.XX B | |
22
+ | Free Cash Flow | $X.XX B | $X.XX B | |
23
+ | Cash & Equivalents | $X.XX B | $X.XX B | |
24
+ | Total Debt | $X.XX B | $X.XX B | |
25
+ | Net Debt / (Net Cash) | $X.XX B | $X.XX B | |
26
+ | Shares Outstanding (dil.) | X.XX B | X.XX B | |
27
+ ```
28
+
29
+ Note below the table: data source (filing section and page number if available).
30
+
31
+ ---
32
+
33
+ ### 5. Highlights & Concerns
34
+
35
+ Two short lists that give the reader the "so what" without leaving the digest. Draw every item directly from the filing and cite the source Item.
36
+
37
+ **Highlights** — up to 5 of the strongest positives disclosed this year (e.g., record revenue, margin expansion, new products/segments, strong FCF conversion, new buyback authorization, market-share gains). Format: `- **[Headline]** — [one sentence] *(Item X)*`
38
+
39
+ **Concerns** — up to 5 of the most material negatives or warning signs (e.g., decelerating growth, margin compression, rising leverage, customer/supplier concentration, new risk factors, active litigation, going-concern language). Format: `- **[Headline]** — [one sentence] *(Item X)*`
40
+
41
+ ---
42
+
43
+ ### 6. Management Outlook & Forward Guidance
44
+
45
+ Capture every forward-looking commitment made in the filing. Present as a table.
46
+
47
+ ```
48
+ | Guidance Item | What Management Said | Time Horizon | Source |
49
+ |----------------------------|-------------------------------------|--------------|------------|
50
+ | Revenue growth | [target / range / directional] | [FY / multi] | Item 7 |
51
+ | Margin target | [gross / operating target] | [horizon] | Item 7 |
52
+ | Capex / capacity | [planned spend or expansion] | [horizon] | Item 7 |
53
+ | Capital allocation | [dividend / buyback / debt / M&A] | [horizon] | Item 7/8 |
54
+ | Strategic priorities | [product roadmap, new markets] | [horizon] | Item 1/7 |
55
+ ```
56
+
57
+ Only include rows the filing actually addresses. If the 10-K gives no explicit guidance (common — 10-Ks are backward-looking), state that and summarize any qualitative forward statements instead.
58
+
59
+ ---
60
+
61
+ ### 7. Prior-Year Promise Tracker
62
+
63
+ An accountability audit: take the forward-looking statements, targets, and stated priorities from **last year's** 10-K (Item 7 MD&A) and score whether they materialized in this year's results. This is the single most differentiating part of the digest — it measures management credibility over time.
64
+
65
+ ```
66
+ | Prior-Year Commitment (FY[N-1] 10-K) | FY[N] Actual Result | Verdict | Notes |
67
+ |-----------------------------------------|------------------------------|-------------|------------------|
68
+ | [what management said they would do] | [what actually happened] | ✅ Delivered | [brief context] |
69
+ | [e.g., "expand operating margin"] | [e.g., "margin +120 bps"] | 🟡 Partial | [brief context] |
70
+ | [e.g., "launch product X in H2"] | [e.g., "slipped to next FY"] | ❌ Missed | [brief context] |
71
+ ```
72
+
73
+ Verdict legend: ✅ Delivered · 🟡 Partial · ❌ Missed · ⏳ Too early to judge.
74
+
75
+ Close with a one-line **Management Credibility read**: e.g., "4/5 prior commitments delivered — high follow-through." If the prior-year 10-K is unavailable, state `N/A — prior filing not retrieved` and skip the table.
76
+
77
+ ---
78
+
79
+ ### 8. Bull vs. Bear Synthesis
80
+
81
+ A lightweight face-off built strictly from evidence in this filing — not a full valuation call (defer to `bear-case`, `stock-eval`, and `stock-valuation` for that).
82
+
83
+ **Bull case** — 3–4 strongest points from this filing supporting the stock.
84
+
85
+ **Bear case** — 3–4 strongest points from this filing arguing against it.
86
+
87
+ **Net read** — one sentence weighing the two, consistent with the Investment Signal below.
88
+
89
+ ---
90
+
91
+ ### 9. Notable Disclosures
92
+
93
+ Bullet list of up to 8 items that are worth investor attention but don't fit neatly into section summaries:
94
+ - New segment or business unit disclosures
95
+ - Changes in accounting estimates or policies
96
+ - Related party transactions
97
+ - Auditor changes
98
+ - Going concern language (if any)
99
+ - New share repurchase authorizations or dividend changes
100
+ - Material acquisitions or divestitures announced
101
+ - Specific named customers or suppliers with concentration risk
102
+
103
+ ---
104
+
105
+ ### 10. Source References
106
+
107
+ List all sources cited in this digest. Format:
108
+
109
+ ```
110
+ ## References
111
+
112
+ 1. **SEC EDGAR Filing** — [Company] 10-K, FY[XXXX]
113
+ URL: https://www.sec.gov/cgi-bin/browse-edgar?...
114
+ Filed: [Date] | Accession No.: [XXXXXXXXXX-XX-XXXXXX]
115
+
116
+ 2. **Item 1 — Business** (pp. X–X of filing)
117
+ 3. **Item 1A — Risk Factors** (pp. X–X of filing)
118
+ 4. **Item 7 — MD&A** (pp. X–X of filing)
119
+ 5. **Item 8 — Financial Statements** (pp. X–X of filing)
120
+ 6. **Item 9A — Controls and Procedures** (pp. X–X of filing)
121
+ 7. **Exhibit 13 / Annual Report to Shareholders** (if incorporated by reference)
122
+ 8. [Any additional sources used, e.g. earnings press release, investor presentation]
123
+ ```
124
+
125
+ If page numbers are unavailable (e.g., pasted text), reference by Item number and section heading.
126
+
127
+ ---
128
+
129
+
@@ -0,0 +1,60 @@
1
+ # Language Mode
2
+
3
+ Part 3 of 3 for `10k-digest` — Language Mode; File Output; Thesis Invalidation
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Language Mode
7
+
8
+ When `--lang zh-TW` is specified, output the **entire document** in Traditional Chinese (繁體中文), including:
9
+ - All section headings translated
10
+ - All narrative summaries written in Traditional Chinese
11
+ - All tables with Chinese column headers
12
+ - Cover block language field: `語言:繁體中文`
13
+ - Keep ticker symbols, financial figures, and SEC item numbers in their original form
14
+
15
+ Suggested Traditional Chinese headings for the interpretation sections: 亮點與隱憂 (Highlights & Concerns), 管理層展望 (Management Outlook & Forward Guidance), 上年度承諾兌現 (Prior-Year Promise Tracker), 多空對決 (Bull vs. Bear Synthesis).
16
+
17
+ English mode is the default when no `--lang` flag is given.
18
+
19
+ ---
20
+
21
+ ## File Output
22
+
23
+ When `--output <filename>` is specified:
24
+ - Save the digest as a markdown file at the specified path
25
+ - If no path separator is present, save in the current directory
26
+ - Confirm the file path after saving: `✓ Digest saved to: <path>`
27
+ - Default filename if `--output` flag is present without a name: `<TICKER>-10k-digest.md`
28
+
29
+ ---
30
+
31
+ ## Thesis Invalidation
32
+
33
+ After delivering the digest, note what would make this document stale:
34
+
35
+ **Re-run this digest when:**
36
+ - [ ] Company files next 10-K or 10-K/A amendment
37
+ - [ ] Material 8-K filed disclosing a restatement or auditor change
38
+ - [ ] 12 months have elapsed since the filing date
39
+
40
+ ```
41
+ ╔══════════════════════════════════════════════╗
42
+ ║ INVESTMENT SIGNAL ║
43
+ ╠══════════════════════════════════════════════╣
44
+ ║ Signal: BULLISH / NEUTRAL / BEARISH ║
45
+ ║ Confidence: HIGH / MEDIUM / LOW ║
46
+ ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
47
+ ║ Score: X.X / 10 ║
48
+ ╠══════════════════════════════════════════════╣
49
+ ║ Action: BUY / HOLD / SELL ║
50
+ ║ Conviction: STRONG / MODERATE / WEAK ║
51
+ ╚══════════════════════════════════════════════╝
52
+ ```
53
+
54
+ Score Guide: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish
55
+ Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
56
+ Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
57
+
58
+ **Disclaimer:** Educational analysis only. Not financial advice.
59
+
60
+
@@ -78,9 +78,11 @@ Claude takes the opposing side of the prior (likely balanced or bullish) analysi
78
78
  ## Read the Parts
79
79
 
80
80
  Everything below the surface of this file lives in `references/`. Open a part with `read`,
81
- resolved against this skill's base directory; each part is sized to arrive complete in one
82
- `read`. If a receipt shows `[... tool result middle pruned ...]`, re-read it with `offset`
83
- before concluding anything is missing.
81
+ resolved against this skill's base directory, and open it **whole — with no line window**:
82
+ reporting a rule or a template out of a slice of a part is how a file gets described as read
83
+ when it was only skimmed. Each part is sized to arrive complete in one `read`. If a receipt
84
+ shows `[... tool result middle pruned ...]`, re-read it with `offset` before concluding
85
+ anything is missing.
84
86
 
85
87
  - `references/10-analysis-framework.md` — Analysis Framework
86
88
  - `references/11-output-and-signal.md` — Output; Signal Output
@@ -38,290 +38,16 @@ Data & Sources
38
38
 
39
39
  ---
40
40
 
41
- ## Persona
41
+ ## Read the Parts
42
42
 
43
- You are an expert event-driven analyst specializing in catalyst identification and event-driven investment strategies. Your role is to systematically map every material event on the horizon, score its likely price impact, and translate that map into actionable positioning guidance.
43
+ Everything below the surface of this file lives in `references/`. **whole, with no line window** — quoting a rule or a template out of a slice of one is how a
44
+ file gets reported as read when it was only skimmed. The file names below are the only
45
+ addressing this entry has.
44
46
 
45
- ---
46
-
47
- ## Overview
48
-
49
- The **Catalyst Calendar** skill identifies and scores upcoming catalysts over a configurable window (default 90 days) for one or more tickers. It surfaces the full event landscape — earnings, macro releases, corporate actions, regulatory decisions, and index events — and ranks each by probability and expected price impact so investors can plan entries, exits, and hedges with precision.
50
-
51
- ---
52
-
53
- ## Input
54
-
55
- ```
56
- [TICKER] [--days 90] [--focus earnings|macro|corporate|all]
57
- ```
58
-
59
- - `TICKER` — single ticker (e.g., `AAPL`) or comma-separated list (e.g., `AAPL,MSFT,NVDA`)
60
- - `--days` — look-ahead window in days (default: 90; max: 180)
61
- - `--focus` — filter to a catalyst category (default: `all`)
62
-
63
- **Example invocations:**
64
- - `/catalyst-calendar TSLA` — full 90-day calendar for Tesla
65
- - `/catalyst-calendar MRNA --focus earnings` — earnings catalysts only for Moderna
66
- - `/catalyst-calendar AAPL,MSFT --days 60` — 60-day calendar comparing Apple and Microsoft
67
-
68
- ---
69
-
70
- ## Section A — Earnings Events
71
-
72
- Earnings are typically the highest-impact recurring catalyst. Analyze the following:
73
-
74
- ### A1. Next Estimated Earnings Date
75
- - Confirm the next earnings date and reporting quarter (e.g., Q2 FY2026, expected late July)
76
- - Note whether the date is confirmed by the company or is an analyst estimate
77
- - Flag if date has shifted from prior guidance (early/late reporting is itself a signal)
78
-
79
- ### A2. Consensus Estimates
80
- - **EPS estimate**: consensus, high, and low analyst estimates
81
- - **Revenue estimate**: consensus, high, and low analyst estimates
82
- - **Year-over-year growth implied** by consensus (EPS growth %, revenue growth %)
83
- - Note estimate revision trend over last 30/60/90 days (rising, falling, stable)
84
-
85
- ### A3. Historical Beat/Miss Rate (Last 8 Quarters)
86
- Present as a table:
87
-
88
- | Quarter | EPS Est | EPS Actual | Beat/Miss | Revenue Est | Revenue Actual | Beat/Miss |
89
- |---------|---------|------------|-----------|-------------|----------------|-----------|
90
-
91
- - Compute beat rate: X/8 quarters
92
- - Note magnitude of surprises (average upside/downside %)
93
- - Highlight any streak (e.g., 6 consecutive beats)
94
-
95
- ### A4. Options-Implied Move
96
- - Estimate the at-the-money straddle price for the nearest expiry bracketing earnings
97
- - **Implied move % = (ATM call price + ATM put price) / stock price**
98
- - Compare to average realized post-earnings move over last 8 quarters
99
- - Flag if implied move is elevated vs. historical (suggests hedging demand or uncertainty)
100
-
101
- ### A5. Pre-Earnings Drift Pattern
102
- - Typical drift direction in the 2 weeks before earnings (positive/negative/flat)
103
- - Average magnitude of pre-earnings drift
104
- - Whether the stock tends to be bought into earnings or distributed (institutional behavior)
105
-
106
- ### A6. Post-Earnings Reaction Guide
107
- - **Beat + raise guidance**: historical average reaction (e.g., +8%)
108
- - **Beat + maintain guidance**: historical average reaction (e.g., +2%)
109
- - **In-line + maintain**: historical average reaction (e.g., -1%)
110
- - **Miss + cut guidance**: historical average reaction (e.g., -12%)
111
- - Identify whether the stock is a "buy the rumor, sell the news" name vs. momentum-driven
112
-
113
- ---
114
-
115
- ## Section B — Macro Catalyst Calendar
116
-
117
- Macro events create sector-wide and market-wide price dislocations. Map the following within the look-ahead window:
118
-
119
- ### B1. FOMC Meeting Dates
120
- - List all FOMC meeting dates in window
121
- - Current market expectation for each meeting (hold/cut/hike, basis points)
122
- - **Rate sensitivity assessment for this stock:**
123
- - Is the stock rate-sensitive? (high-growth tech, REITs, utilities are most sensitive)
124
- - Direction of impact: higher rates = negative/positive/neutral for this ticker
125
- - Historical correlation: how has the stock moved on prior FOMC days?
126
-
127
- ### B2. CPI / PCE Release Dates
128
- - List CPI and core PCE release dates in window
129
- - **Inflation sensitivity for this sector:**
130
- - Does the company benefit from inflation (commodity producers, pricing-power names)?
131
- - Does the company suffer from inflation (thin-margin retailers, manufacturers with input cost exposure)?
132
- - Historical reaction to hot vs. cool CPI prints
133
-
134
- ### B3. Jobs Report (NFP) Dates
135
- - List Non-Farm Payroll release dates in window
136
- - **Cyclical vs. defensive classification:**
137
- - Strong jobs = risk-on: bullish for cyclicals, bearish for defensives
138
- - Weak jobs = risk-off: bearish for cyclicals, neutral-to-bullish for defensives
139
- - Classify this ticker accordingly
140
-
141
- ### B4. Treasury Auction Dates
142
- - Note major Treasury auction dates (10Y, 30Y) in window
143
- - Relevant primarily for rate-sensitive equities (financials, REITs, utilities, high-duration tech)
144
- - Flag if auction is expected to have unusual supply or demand dynamics
145
-
146
- ---
147
-
148
- ## Section C — Company-Specific Catalysts
149
-
150
- Beyond earnings and macro, company-level events often produce the largest idiosyncratic moves:
151
-
152
- ### C1. Analyst / Investor Day
153
- - Typical cadence (annual, biannual, ad hoc)
154
- - Date of last Investor Day and key announcements made
155
- - Whether an Investor Day is expected within the window (positive: management engagement; risk: guidance reset)
156
-
157
- ### C2. Product Launches & Major Announcements
158
- - Known or expected product launches, version releases, or platform announcements
159
- - Conference appearances where new product reveals are customary (e.g., Apple WWDC, NVIDIA GTC)
160
- - Expected launch dates and potential revenue contribution
161
-
162
- ### C3. FDA Approvals / Regulatory Decisions *(Biotech & Pharma Only)*
163
- - PDUFA dates (FDA action dates) within window
164
- - Probability of approval (analyst consensus, prior CRL history)
165
- - Binary impact estimates (approval: +X%, rejection: -Y%)
166
- - Any advisory committee (AdCom) meetings preceding the decision
167
-
168
- ### C4. Index Rebalancing Eligibility
169
- - Is the stock a candidate for S&P 500, Russell 2000/1000, or MSCI inclusion/exclusion?
170
- - Next rebalancing date for relevant indices
171
- - Estimated passive fund buying or selling flows upon inclusion/exclusion
172
- - Historical index inclusion premium for comparable stocks
173
-
174
- ### C5. Lock-Up Expiration Dates
175
- - Applicable if IPO or secondary offering occurred within last 18 months
176
- - Lock-up expiration date and total shares becoming eligible for sale
177
- - Insider/sponsor ownership as % of float (higher % = greater overhang risk)
178
- - Historical price behavior in the 2–4 weeks surrounding lock-up expirations
179
-
180
- ### C6. Debt Maturity / Refinancing Windows
181
- - Any significant debt maturities within the window
182
- - Current credit conditions and refinancing cost vs. existing rate
183
- - Refinancing risk (can the company refinance at acceptable terms?)
184
- - Relevant if leverage is elevated (Net Debt/EBITDA > 3×)
185
-
186
- ### C7. Contract Renewals / Government Budget Cycles
187
- - Applicable for defense contractors, government IT, healthcare services
188
- - Key contract renewal dates and estimated contract value
189
- - Government fiscal year-end effects (accelerated spending in Q4 FY = Sep 30)
190
- - Continuing resolution or budget uncertainty risk
191
-
192
- ### C8. Management Conference Presentations
193
- - Upcoming presentations at major industry conferences (e.g., JPM Healthcare Conference, CES, Mobile World Congress, Goldman Sachs Communacopia)
194
- - Management tone and guidance updates historically provided at these events
195
- - Whether management has a history of pre-announcing or guiding at conferences
196
-
197
- ---
198
-
199
- ## Section D — Catalyst Impact Scoring Table
200
-
201
- Synthesize all identified catalysts into a unified scoring table. For each catalyst:
202
-
203
- | Est. Date | Event | Probability | Bull Impact | Bear Impact | Net Bias | Pre-event Action |
204
- |-----------|-------|-------------|-------------|-------------|----------|-----------------|
205
- | YYYY-MM-DD | [Event name] | High/Med/Low | +X% | -Y% | Bullish/Bearish/Binary/Neutral | Buy dip before / Reduce ahead / Hold / Hedge |
206
-
207
- **Scoring Guidance:**
208
- - **Probability**: High (>70%), Medium (40–70%), Low (<40%) of the bullish outcome occurring
209
- - **Bull Impact**: Expected % upside in the bullish scenario
210
- - **Bear Impact**: Expected % downside in the bearish scenario (express as negative)
211
- - **Net Bias**: Overall directional lean given probability-weighted outcomes
212
- - Bullish: probability-weighted EV clearly positive
213
- - Bearish: probability-weighted EV clearly negative
214
- - Binary: roughly equal bull/bear outcomes with high magnitude
215
- - Neutral: low magnitude or offsetting scenarios
216
- - **Pre-event Action**: recommended positioning ahead of the event
217
-
218
- **Rank catalysts** by absolute expected value (probability × average of |bull| and |bear| impacts) to identify the highest-priority events.
219
-
220
- ---
221
-
222
- ## Section E — Event-Driven Strategy Suggestions
223
-
224
- Translate the catalyst map into actionable playbooks:
225
-
226
- ### E1. Pre-Event Positioning Playbook
227
- - **High beat-rate earnings (>65%)**: Consider initiating or adding to position 10–15 trading days before earnings; scale out 1–2 days before if implied move is elevated (IV crush risk)
228
- - **Known positive catalysts (FDA, index inclusion)**: Build position in 4–6 week advance window; use limit orders on any dips
229
- - **Macro tailwinds**: Align sector positioning with upcoming FOMC/CPI if macro bias is clear
230
- - **Conference presentations**: Monitor for pre-conference guidance updates; light positioning ahead of known presenter history
231
-
232
- ### E2. Post-Event Reaction Guide
233
- - **IV Crush after earnings**: If IVR (Implied Volatility Rank) > 70 heading into earnings, short straddle or iron condor captures elevated premium; exit immediately after event
234
- - **Buy the dip on good numbers**: If stock drops despite a beat (typical for high-valuation names), treat as accumulation opportunity within 3 sessions post-earnings
235
- - **Sell the rip on binary events**: For FDA decisions or index inclusions, partial profit-taking on the opening gap is prudent — anticipation premium often fully priced in
236
-
237
- ### E3. Binary Event Hedges
238
- - **Protective puts**: For high-probability binary events (FDA decision, regulatory ruling), buy puts 1–2 strikes out-of-the-money, expiring shortly after the event date. Cost: typically 2–5% of position value.
239
- - **Collars**: For large existing positions, sell a covered call to finance a protective put — capping upside while limiting downside around the binary event
240
- - **Straddle (long)**: When implied move is below historical realized move (options are "cheap"), a long straddle profits from a larger-than-expected move in either direction
241
-
242
- ### E4. Catalyst Stacking — Convergence Windows
243
- - Identify 2-week windows where 2 or more catalysts converge (e.g., earnings + FOMC in same week)
244
- - **Stacked bullish catalysts**: If both events lean bullish, the combined setup is high-conviction — size up accordingly
245
- - **Stacked binary or offsetting catalysts**: Increased volatility expected; reduce position sizing or hedge both directions
246
- - **Catalyst fatigue**: After a string of positive catalysts resolves, upside may be limited until the next catalyst cycle — consider trimming into strength
247
-
248
- ---
249
-
250
- ## Section F — 90-Day Catalyst Heat Map
251
-
252
- Visualize catalyst density across the look-ahead window as an ASCII weekly calendar. Use block shading to indicate event intensity:
253
-
254
- ```
255
- ░░░ = Low (0–1 minor catalysts)
256
- ██ = Medium (1–2 moderate catalysts)
257
- ████ = HIGH (3+ catalysts or 1 major binary event)
258
- ```
259
-
260
- **Example output format:**
261
-
262
- ```
263
- 90-Day Catalyst Heat Map — [TICKER]
264
- ════════════════════════════════════════════════════════
265
-
266
- Week 1 (Jun 23 – Jun 27): ░░░ Low — Quiet period
267
- Week 2 (Jun 30 – Jul 4): ████ HIGH — Earnings + FOMC
268
- Week 3 (Jul 7 – Jul 11): ██ Medium — CPI release
269
- Week 4 (Jul 14 – Jul 18): ░░░ Low — Quiet period
270
- Week 5 (Jul 21 – Jul 25): ██ Medium — Investor Day
271
- Week 6 (Jul 28 – Aug 1): ░░░ Low — Quiet period
272
- Week 7 (Aug 4 – Aug 8): ██ Medium — Jobs Report + FOMC minutes
273
- Week 8 (Aug 11 – Aug 15): ████ HIGH — FDA PDUFA + CPI
274
- Week 9 (Aug 18 – Aug 22): ░░░ Low — Quiet period
275
- Week 10 (Aug 25 – Aug 29): ░░░ Low — Quiet period
276
- Week 11 (Sep 1 – Sep 5): ██ Medium — Jobs Report
277
- Week 12 (Sep 8 – Sep 12): ██ Medium — Conference presentation
278
- Week 13 (Sep 15 – Sep 19): ████ HIGH — FOMC + index rebalancing
279
-
280
- ════════════════════════════════════════════════════════
281
- Peak Risk Window: Jul 1 – Jul 11 (earnings + macro overlap)
282
- Quietest Window: Jul 14 – Jul 25 (low catalyst density, favorable for accumulation)
283
- ```
284
-
285
- Adjust weeks and labels to match the actual look-ahead window and identified catalysts.
286
-
287
- ---
288
-
289
- ## Thesis Invalidation
290
-
291
- **If catalyst outlook is BULLISH — it breaks if:**
292
- - Earnings miss by >10% AND guidance lowered
293
- - FOMC surprise rate hike >25bps above consensus
294
- - Key product launch delayed >1 quarter
295
- - FDA rejection or Complete Response Letter (CRL) issued
296
- - Index inclusion candidate excluded from rebalancing
297
-
298
- **If catalyst outlook is BEARISH — it breaks if:**
299
- - Major earnings beat with raised guidance
300
- - Positive regulatory surprise (FDA approval, contract win)
301
- - Index inclusion announcement
302
- - Activist investor disclosure or buyout rumor
303
- - Macro surprise (emergency rate cut, strong CPI miss to downside)
304
-
305
- **Re-run this analysis when:**
306
- - [ ] Earnings date confirmed / officially announced by the company
307
- - [ ] Major news event changes catalyst timeline (acquisition, spin-off, regulatory action)
308
- - [ ] 30 days elapsed (calendar and estimates both update)
309
- - [ ] Implied volatility moves >20% from levels at time of this analysis
310
- - [ ] Analyst coverage changes materially (new initiations or target price revisions >15%)
311
-
312
- ---
313
-
314
- ```
315
- ╔══════════════════════════════════════════════╗
316
- ║ INVESTMENT SIGNAL — CATALYST CALENDAR ║
317
- ╠══════════════════════════════════════════════╣
318
- ║ Next Catalyst: [EVENT] on [DATE] ║
319
- ║ 30-Day Bias: BULLISH / NEUTRAL / BEARISH ║
320
- ║ Catalyst Density: HIGH / MEDIUM / LOW ║
321
- ╠══════════════════════════════════════════════╣
322
- ║ Highest Impact: [EVENT] — [±X%] expected ║
323
- ║ Risk Window: [DATE RANGE] ║
324
- ╚══════════════════════════════════════════════╝
325
- ```
47
+ - `references/10-persona.md` — Persona; Overview; Input; Section A — Earnings Events; Section B — Macro Catalyst Calendar
48
+ - `references/11-section-c-company-specific.md` — Section C — Company-Specific Catalysts; Section D — Catalyst Impact Scoring Table; Section E — Event-Driven Strategy Suggestions
49
+ - `references/12-section-f-90-day.md` — Section F — 90-Day Catalyst Heat Map; Thesis Invalidation
326
50
 
327
- **Disclaimer:** Educational analysis only. Not financial advice.
51
+ Loading this file is not reading the skill: the steps, templates, and thresholds exist only
52
+ in the parts above. Say which parts you opened, name the ones you did not, and never report a
53
+ step or a template you have not read in this session.