@v587d/capital-generation 2.10.2 → 2.11.1

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md

@@ -3,65 +3,38 @@
 Part 2 of 3 for `earnings-call-analysis` — Data Sources; Input Formats; Output; Analysis Guidelines; Usage Examples; Integration Notes; Standard Signal Output
 See `SKILL.md` for what to read and when; this part is procedure, not routing.
 
-## Data Sources
+## Evidence request
 
-Reference the following sources when analyzing earnings calls:
+Ask for the evidence this analysis needs through the host data contract, in one request:
 
-### Primary Sources
-- **SEC EDGAR 8-K Filings**: Official transcripts filed within 4 days of call
-  - Search: https://www.sec.gov/edgar/searchedgar/companysearch.html
-  - Look for: Item 2.02 (Results of Operations and Financial Condition)
+- the latest call: transcript with prepared remarks and Q&A, call date, fiscal quarter, and the venue or document that carries it
+- the filing that accompanies it: the results release (8-K / 6-K items) or the 10-Q / 10-K the call refers to
+- the materials distributed with the call: press release, investor presentation, supplemental schedules
+- the prior-quarter call, for comparison
+- a consensus or guidance baseline only if the host actually returned one, labelled as such
 
-- **Company Investor Relations**: Live webcasts and archived recordings
-  - Typically at: [company-website.com]/investors/earnings
-  - May include slides and supplemental materials
+Do not ask the user to pick a data vendor and do not request credentials: the host decides where the evidence comes from and returns each item with provenance (venue, document, date, accession or link). State the as-of date on every figure the analysis leans on, and keep the period labels (fiscal quarter, trailing twelve months) exactly as the evidence source defines them. If the transcript cannot be retrieved, say so and stop the transcript-dependent parts — never reconstruct quotes, tone or Q&A from memory.
 
-### Transcript Services
-- **Seeking Alpha**: Free transcript archive with searchable database
-  - Format: https://seekingalpha.com/symbol/[TICKER]/earnings/transcripts
+## Input formats
 
-- **AlphaSense**: Premium transcript service with AI search (paid)
-- **Bloomberg Terminal**: Real-time transcripts and historical archive (paid)
-- **FactSet**: Transcript archive with analytics (paid)
+### Format 1: Transcript text
 
-### Supplementary Information
-- **Earnings Press Release**: Published before call, contains prepared financial results
-- **Investor Presentation Slides**: Visual aids referenced during call
-- **10-Q/10-K Filings**: Detailed financials for context
-- **Prior Quarter Calls**: For comparison and trend analysis
+Paste the transcript as returned by retrieval, including the corporate participants section, prepared remarks, the Q&A and any forward-looking disclaimer. Treat it as `pasted by user`.
 
-## Input Formats
+### Format 2: Call details only
 
-Accept earnings call data in the following formats:
-
-### Format 1: Transcript Text
-```
-Paste the full transcript text from the earnings call, including:
-- Corporate Participants section
-- Prepared Remarks
-- Q&A Session
-- Forward-Looking Statements disclaimer (if present)
-```
-
-### Format 2: Transcript URL
-```
-Provide URL to transcript:
-- Seeking Alpha URL
-- Company IR page URL
-- SEC EDGAR filing link
-```
-
-### Format 3: Call Details for Manual Analysis
 ```
 Company: [Name]
 Ticker: [SYMBOL]
 Quarter: Q[1-4] [YEAR]
-Call Date: [MM/DD/YYYY]
+Call date: [MM/DD/YYYY]
 
-Key Questions to Focus On:
-- [Specific aspects to analyze]
+Key questions to focus on:
+- [specific aspects to analyze]
 ```
 
+With only call details, request the transcript and the accompanying filing through the host channel first. If neither comes back, deliver the framework, name the missing fields, and stop short of writing a transcript analysis; a press release alone supports the guidance section but not the tone or Q&A reads, so say which sections the evidence actually covers.
+
 ## Output
 
 Provide comprehensive earnings call analysis report with:
@@ -184,7 +157,7 @@ Claude compares with prior quarter (Q3 2024) to highlight changes and trends
 ## Integration Notes
 
 - Can be used standalone or in conjunction with /stock-eval
-- Output can be fed to /report-generator for HTML/PDF export
+- Chart-ready tables stay in the answer; the host chart channel renders them (this plugin exports no HTML/PDF)
 - Particularly valuable around earnings season (Jan, Apr, Jul, Oct)
 - Best used within 1-2 days of earnings release while market is digesting information
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md

@@ -5,6 +5,13 @@ description: The before-earnings skill — consensus vs. whisper, 8-quarter beat
 
 # Earnings Preview — What Is Priced In Before the Print
 
+## Evidence request
+
+通过宿主数据契约请求：财务报表（三表与附注，注明期间与 as-of）、期权链（行权价、到期、IV、持仓量）、宏观序列（数值、期间与发布日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest market data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the number is t
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md

@@ -5,11 +5,18 @@ description: Analyze US economic indicators and their impact on markets
 
 # US Economics Analysis
 
+## Evidence request
+
+通过宿主数据契约请求：宏观序列（数值、期间与发布日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, retrieve the latest release of every indicator you use:
 
-1. **Fetch current readings** — get the latest value and release date of each indicator (FRED, BLS, BEA, ISM, the Fed) through the host's own data path; delegate the request in a role-split host. Never assume a reading from training data; indicators are revised and re-released on a schedule.
+1. **Fetch current readings** — get the latest value and release date of each indicator (policy rate, inflation, employment, activity and sentiment releases) through the host's own data path; delegate the request in a role-split host. Never assume a reading from training data; indicators are revised and re-released on a schedule.
 2. **Confirm key figures** — the policy rate, the 2s10s spread, the latest CPI/PCE, payrolls and unemployment, and PMI, each with its release date.
 3. **State your data source** — fill in the `Data & Sources` header (next section) so the origin, as-of date, retrieval path, and confidence of every figure are explicit at the top of the output.
 4. **Stop on missing data** — if a figure cannot be retrieved through the host's data path, name what is missing and stop; the analysis does not run on remembered values:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the print is th
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md

@@ -5,6 +5,13 @@ description: ETF / index-fund due diligence — expense ratio vs. category, trac
 
 # ETF Analysis — What You Actually Own, and What It Costs You
 
+## Evidence request
+
+通过宿主数据契约请求：行情序列（复权口径与 as-of）、披露文件（公告、年报或招股书，带回出处与文档日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest fund data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the factsheet i
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md

@@ -1,16 +1,23 @@
 ---
 name: fact-check
-description: Claim-level verification of any report or data set — extract every figure and factual claim, check each against a primary source (SEC filing, company IR, FRED, exchange data, or the user's own document), recompute derived numbers, mark ✅ verified / ⚠️ mismatch / ❓ unverifiable, and re-issue the report with inline citations and a References section; Verification Score 0–10
+description: Claim-level verification of any report or data set — extract every figure and factual claim, check each against a primary source (a statutory filing, an official statistics release, exchange data, issuer material, or the user's own document), recompute derived numbers, mark ✅ verified / ⚠️ mismatch / ❓ unverifiable, and re-issue the report with inline citations and a References section; Verification Score 0–10
 ---
 
 # Fact Check — Verify the Numbers, Cite the Sources
 
+## Evidence request
+
+通过宿主数据契约请求：披露文件（公告、年报或招股书，带回出处与文档日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before verifying anything, establish what data each claim actually needs:
 
 1. **Fetch current price only where a claim needs it** — market claims (price, market cap, yield, multiples "today") are checked against a live quote for the report's as-of date and today's, obtained through the host's own data path (delegate it in a role-split host). Reported figures, historical comparisons, and `--recompute` runs need **no** live quote — do not request one, and do not let its absence block them. Never assume a price from training data.
-2. **Confirm key figures** — for this skill the "key figures" are the *sources themselves*: the filing (10-K / 10-Q / 8-K / proxy / Form 4 / 13F), the IR release, the FRED series, the exchange or issuer data, or the document the user pasted. Retrieve or request them before judging a single claim. A claim checked against memory is not checked.
+2. **Confirm key figures** — for this skill the "key figures" are the *sources themselves*: the filing (10-K / 10-Q / 8-K / proxy / Form 4 / 13F), the issuer release, the official statistics release, the exchange or issuer data, or the document the user pasted. Retrieve or request them before judging a single claim. A claim checked against memory is not checked.
 3. **State your data source** — fill in the `Data & Sources` header (next section) so the origin, as-of date, retrieval path, and confidence of every figure are explicit at the top of the output.
 4. **Flag stale data explicitly** — if a live quote is needed for a market claim and unavailable, display this warning before proceeding, and mark those claims `❓` or `🕒` rather than guessing:
 
@@ -22,12 +29,12 @@ The warning describes the *inputs actually used*: when every claim was checked a
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md

@@ -53,7 +53,7 @@ Read the report once and list **every** checkable statement — not just the hea
 | 4 | "CFO bought $1.2M of stock in May" | $1.2M · 2026-05 | fact (Form 4) | — | §5 Insider |
 | 5 | "top customer is 18% of revenue" | 18% · FY2026 | reported (10-K risk factors) | — | §1 |
 
-**Claim types** decide which source can verify them: *reported* (a figure stated in a filing or release), *derived* (computed from reported figures — must be recomputed, not just matched), *market* (price, market cap, yield — needs an as-of date), *estimate* (consensus, guidance — needs the source and date of the estimate), *macro* (rates, CPI — FRED / BLS series and vintage), *fact* (an event: a filing, a transaction, an appointment), *qualitative* (a characterization — "dominant", "improving" — checked for whether the cited evidence supports it, never marked verified on its own).
+**Claim types** decide which source can verify them: *reported* (a figure stated in a filing or release), *derived* (computed from reported figures — must be recomputed, not just matched), *market* (price, market cap, yield — needs an as-of date), *estimate* (consensus, guidance — needs the source and date of the estimate), *macro* (rates, CPI — official statistics series and their vintage), *fact* (an event: a filing, a transaction, an appointment), *qualitative* (a characterization — "dominant", "improving" — checked for whether the cited evidence supports it, never marked verified on its own).
 
 Mark the **signal-driving** claims. They carry more weight in the score and a mismatch on one of them changes the report's standing.
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md

@@ -9,14 +9,20 @@ Only a source the reader could open verifies a claim. Rank what you use, and rec
 
 | Tier | Sources | Verifies |
 |------|---------|----------|
-| **1 — Primary** | SEC EDGAR filings (10-K, 10-Q, 8-K, DEF 14A, Form 4, 13F, S-1), the company's own IR release or presentation, FRED / BLS / BEA series, the exchange's or ETF issuer's published data, IRS publications, the fund prospectus / factsheet | reported figures, facts, macro, fund data |
+| **1 — Primary** | statutory filings (10-K, 10-Q, 8-K, DEF 14A, Form 4, 13F, S-1), the company's own release or presentation, official statistics releases, the exchange's or ETF issuer's published data, tax-authority publications, the fund prospectus / factsheet | reported figures, facts, macro, fund data |
 | **1 — User-supplied** | The document the user pasted (a filing excerpt, a broker statement, a data export) | its own figures — labelled `user-supplied` so the reader knows verification stops at the user's document |
-| **2 — Secondary** | Reputable financial data vendors and press explicitly quoting a primary document, consensus aggregators for estimates | market data and estimates, with the vendor and date recorded; a reported figure verified only at Tier 2 is marked `✅ (secondary)` |
+| **2 — Secondary** | Reputable data vendors and press explicitly quoting a primary document, plus consensus aggregators for estimates | market data and estimates, with the vendor and date recorded; a reported figure verified only at Tier 2 is marked `✅ (secondary)` |
 | **3 — Not a source** | Model memory, forum posts, uncited summaries, a second AI output | nothing — a claim matched only against these stays `❓` |
 
 Prefer the most specific location: Item and Note number, statement line, table, page. "The 10-K" is a document, not a citation.
 
-**Retrieving a Tier-1 source without an API key.** Once retrieval is approved, go straight to SEC EDGAR rather than a summary site — in a role-split host, hand the URL and the fields needed to the agent that owns retrieval rather than fetching here: resolve the CIK from `https://www.sec.gov/files/company_tickers.json` (zero-pad `cik_str` to 10 digits); list filings from `https://data.sec.gov/submissions/CIK##########.json`, where `filings.recent.form` / `filingDate` / `reportDate` / `accessionNumber` / `primaryDocument` line up by index (`10-K`, `10-Q`, `8-K`, `DEF 14A`, `4` for insider transactions — Form 4s are filed under the issuer's CIK as well as the insider's — and `20-F` / `6-K` for foreign issuers); open the document at `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accession without dashes>/<primaryDocument>`; and cross-check statement figures against the tagged facts at `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`. Send an identifying `User-Agent` and stay under 10 requests per second. Record `Retrieval: web/tool retrieval`, the accession number and the filing date. **Institutional holdings are the exception to the issuer-CIK route:** Form `13F-HR` is filed by the investment *manager*, so it never appears under the target company's CIK. Resolve the manager (from the claim: "Vanguard holds 8.9%") to *its* CIK, list its `13F-HR` filings, and verify the position in the information table by the target's CUSIP — or use EDGAR full-text search (`https://www.sec.gov/edgar/search/#/q=%22<company or CUSIP>%22&forms=13F-HR`) to find which managers report the security. A 13F verifies one manager's position at one quarter-end; an aggregate "institutional ownership %" is a secondary-source figure and is marked `✅ (secondary)` at best. Only where the host has no retrieval path at all, ask the user to paste the document and mark `Retrieval: pasted by user` — the repository's helper scripts are not part of this plugin and are never run from here. A source that could not be retrieved leaves its claims `❓`; it is never filled from memory.
+**Requesting a Tier-1 source.** Once retrieval is approved, ask the host data contract for the document rather than a summary page — in a role-split host the request goes to the agent that owns retrieval, never out of the analysis role. Put in the request: the issuer or manager, the form (`10-K`, `10-Q`, `8-K`, `DEF 14A`, `4` for insider transactions — Form 4s are filed under the issuer's CIK as well as the insider's — `20-F` / `6-K` for foreign issuers), the period, the sections or exhibits needed, and the return fields: document text, venue, filing date, accession, link. When tagged statement facts come back with the filing, use them to cross-check the figures read from Item 8. Record `Retrieval: web/tool retrieval`, the accession number and the filing date.
+
+**Institutional holdings are the exception to the issuer route:** Form `13F-HR` is filed by the investment *manager*, so it never appears under the target company's CIK. Ask by manager (from the claim: "Vanguard holds 8.9%") and verify the position in the information table by the target's CUSIP — or ask retrieval to search filings by company or CUSIP to find which managers report the security. A 13F verifies one manager's position at one quarter-end; an aggregate "institutional ownership %" is a secondary-source figure and is marked `✅ (secondary)` at best.
+
+Only where the host has no retrieval path at all, ask the user to paste the document and mark `Retrieval: pasted by user`. A source that could not be retrieved leaves its claims `❓`; it is never filled from memory.
+
+**What each retrieved item must let you write.** For every primary source, record the venue, the document and its date, the period it covers, and the accession or link the retrieval returned. A citation you cannot fill this way is not a citation: drop the claim back to `❓` rather than naming a document you did not receive. When two returned sources disagree, keep both rows, show the period and the accounting basis each one uses, and let the verdict carry the conflict — do not average them into a third figure the sources never reported, and do not quietly prefer the one that supports the claim.
 
 ### Phase 3 — Verify each claim
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md

@@ -10,7 +10,7 @@ See `SKILL.md` for what to read and when; this part is procedure, not routing.
 - **Unverifiable is not false.** The corrected copy must never read as if a `❓` claim were refuted. The honest output for a claim without a source is the claim, unchanged, with `[?]`.
 - **Fiscal calendars cause most false mismatches.** Establish the fiscal year end and the period each table covers before comparing anything.
 - **Do not fabricate a reference to fill a gap.** No accession number, page, or URL that was not actually seen. If the environment cannot retrieve, report the claim as blocked — do not fall back to memory.
-- **Pairs with**: `result-validator` (consumes the score), `learning-coach` (explains the ledger to a beginner), `10k-digest` and `financial-report-analyst` (produce well-cited inputs in the first place), `full-report` (run this on the composite before shipping it), `thesis-tracker` (verify the KPI values before recording them at a check).
+- **Pairs with**: `result-validator` (consumes the score), `learning-coach` (explains the ledger to a beginner), `10k-digest` and `financial-report-analyst` (produce well-cited inputs in the first place), `thesis-tracker` (verify the KPI values before recording them at a check); re-run this ledger on the composite before it goes into the final answer.
 
 ## Thesis Invalidation
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md

@@ -5,6 +5,13 @@ description: Analyze company financial reports (10-K, 10-Q, annual reports) and
 
 # Financial Report Analyst
 
+## Evidence request
+
+通过宿主数据契约请求：披露文件（公告、年报或招股书，带回出处与文档日期）、财务报表（三表与附注，注明期间与 as-of）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest market data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the number is t
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md

@@ -30,18 +30,19 @@ Provide the report in one of these ways:
 /financial-report-analyst GOOGL --compare-prior
 ```
 
-### Retrieving the filing — the keyless EDGAR path
+### Evidence request — the filing
 
-When the user names a ticker instead of pasting text, this skill still fetches nothing by itself. Get the primary document from SEC EDGAR (free, no API key) **through the host's retrieval path — delegate it in a role-split host** — and mark `Retrieval: delegated retrieval`:
+When the user names a ticker instead of pasting text, this skill still fetches nothing by itself. Ask the host data contract for the primary document and mark `Retrieval: delegated retrieval`:
 
-1. **Ticker → CIK:** `https://www.sec.gov/files/company_tickers.json` — match `ticker` (`BRK-B` for `BRK.B`), zero-pad `cik_str` to 10 digits.
-2. **Filings index:** `https://data.sec.gov/submissions/CIK##########.json` — in `filings.recent`, the arrays `form` · `filingDate` · `reportDate` · `accessionNumber` · `primaryDocument` line up by index. Pick the newest row whose `form` is the one asked for: `10-K` (annual; `20-F` for foreign private issuers), `10-Q` (quarterly; `6-K` for foreign issuers), `8-K` (earnings release is usually Exhibit 99.1 in the filing folder), `DEF 14A` (proxy).
-3. **Document:** `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>` — the full filing as HTML. The folder's `<accessionNumber>-index.htm` lists every exhibit.
-4. **Statement facts (to cross-check Item 8):** `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`.
+- **What to ask for** — the filing the analysis is about: form (`10-K` annual, `10-Q` quarterly, `8-K` for the results release, `DEF 14A` proxy; `20-F` / `6-K` for foreign private issuers), the fiscal period, the filing date, the accession number, and the sections to read.
+- **What comes back** — the document, the exhibit list when the release is an exhibit, and provenance: venue, document, date, accession or the link the retrieval returned.
+- **Cross-checks** — when tagged statement facts come back with the filing, use them to confirm the figures read from Item 8 and say which you used.
 
-Identify yourself with a `User-Agent` header (`Name email`) and stay under 10 requests per second. For `--compare-prior`, take the second-newest row of the same form. Cite accession number and filing date in the `Data & Sources` header.
+For `--compare-prior`, ask for the prior-period filing of the same form in the same request. Cite the accession number and filing date in the `Data & Sources` header. The retrieval role owns identifier lookup and document access; this skill never searches or downloads by itself.
 
-Only where the host has no retrieval path at all, ask the user to paste the sections and mark `Retrieval: pasted by user` — the repository's helper scripts are not part of this plugin and are never run from here. If neither is available, the figures stay missing: report the gap under the ⚠️ warning instead of lowering confidence on an estimate.
+Only where the host has no retrieval path at all, ask the user to paste the sections and mark `Retrieval: pasted by user`. If neither is available, the figures stay missing: report the gap under the ⚠️ warning instead of lowering confidence on an estimate.
+
+When the results release arrives as an exhibit rather than the filing itself, say so and name the exhibit in the citation; an 8-K exhibit and the 10-Q that follows it are different documents with different review levels, and a figure lifted from one cannot be attributed to the other. Read the sections in the order the request returned them, and quote the page or Item you are reading — a section summary that cannot be traced back to a page is not usable evidence for the ratios that follow, and it cannot be re-checked by anyone reading the answer later.
 
 ---
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md

@@ -5,6 +5,13 @@ description: Map an industry's supply / value chain as a directed graph — upst
 
 # Industry Map — Supply & Value Chain
 
+## Evidence request
+
+通过宿主数据契约请求：行业数据（产量、价格、政策，注明来源与日期）、披露文件（公告、年报或招股书，带回出处与文档日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest market data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the number is t
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md

@@ -13,7 +13,7 @@ A value chain is a **directed graph**: nodes are the layers of production (raw m
 2. **Chokepoints** — the layer(s) with the fewest credible suppliers capture disproportionate value. Following the chain reveals bottleneck monopolies (e.g. EUV lithography, leading-edge foundry) that are the real toll-collectors of a theme.
 3. **Value migration** — the profit pool is not fixed. It shifts down (or up) the chain over time as scarcity moves. Mapping the chain lets you form a thesis about *where the money goes next* — the "picks-and-shovels" and second-order plays.
 
-This complements — and does not duplicate — the existing skills. `competitor-analysis` studies one company's moat *horizontally* against its direct peers; `sector-analysis` ranks the 11 GICS sectors for rotation. This skill maps a theme or product *vertically*, cutting **across** sectors, to show the whole flow. Output feeds naturally into `competitor-analysis` (pick a node, study its moat), `stock-screener` (rank the tickers at one layer), and `chart-master` / `report-generator` (render the graph).
+This complements — and does not duplicate — the existing skills. `competitor-analysis` studies one company's moat *horizontally* against its direct peers; `sector-analysis` ranks the 11 GICS sectors for rotation. This skill maps a theme or product *vertically*, cutting **across** sectors, to show the whole flow. Output feeds naturally into `competitor-analysis` (pick a node, study its moat), `stock-screener` (rank the tickers at one layer), and, when a chart is wanted, the host chart channel (the graph spec stays in the answer; this plugin renders through `render_chart` only in its drawing role).
 
 ---
 
@@ -65,7 +65,7 @@ Confirm the boundaries: where does the chain start (how far upstream — mined o
 
 ## 3. Step 2 — Build the Chain Map (the graph)
 
-Produce the directed graph. **Default to a Mermaid `flowchart`** (renders in Claude, Cursor, Gemini, GitHub, and the site); fall back to ASCII when Mermaid is unavailable. Hand off to `chart-master` for a richer HTML render or for a `report-generator` export.
+Produce the directed graph. **Default to a Mermaid `flowchart`** (renders in Claude, Cursor, Gemini, GitHub, and the site); fall back to ASCII when Mermaid is unavailable. Keep this Mermaid block as the primary output; when a richer render is wanted, leave the graph spec in the answer for the host chart channel — this plugin exports no HTML.
 
 **Mermaid flowchart (primary output):**
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md

@@ -5,7 +5,7 @@ See `SKILL.md` for what to read and when; this part is procedure, not routing.
 
 ## 11. Visualization Support
 
-When `--visual` is used, provide graph specs ready for `chart-master` / `report-generator`:
+When `--visual` is used, provide graph specs ready for the host chart channel:
 
 ### Chain Graph
 **Chart type**: Directed graph (Mermaid `flowchart LR` primary, ASCII fallback, graphviz/HTML for rich export). Nodes = layers with representative tickers; edges = supplier→customer flow.

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md

@@ -5,6 +5,13 @@ description: Track and analyze insider buying/selling activity from SEC Form 4 f
 
 # Insider Trading Analysis
 
+## Evidence request
+
+通过宿主数据契约请求：披露文件（公告、年报或招股书，带回出处与文档日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest market data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the number is t
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md

@@ -53,32 +53,17 @@ Identify concerning patterns:
 - Look at historical patterns for that individual
 - Assess whether selling is proportional to holdings
 
-### 10. Data Sources & Research Tools
+### 10. Evidence to request
 
-Reference the following sources for insider trading data:
+Ask the host data contract for insider filings and their fields:
 
-**Primary Source - SEC EDGAR**
-- Form 4 filings: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=4&company=[TICKER]
-- Form 3 filings: Initial beneficial ownership
-- Form 5 filings: Annual statements
-- File within 2 business days of transaction (Form 4)
+- **Filings** — Forms 3, 4 and 5 for the issuer and for the insiders named in the claim; a Form 4 is due within two business days of the transaction
+- **Return fields** — insider name and title, transaction date, filing date, shares bought or sold, price per share, shares owned after the transaction, transaction code (P, S, M, …), and any 10b5-1 plan footnote
+- **Aggregates** — an insider-sentiment or cluster score is a secondary figure unless it names the filings it was computed from; label it as such
 
-**Aggregator Websites**
-- **OpenInsider.com**: Free, comprehensive database with filters
-  - Cluster analysis tools
-  - Screeners for significant transactions
-  - Historical data back 10+ years
+Request by issuer and by insider, not by vendor. A filing that cannot be retrieved stays missing; do not fill the row from a summary site or from memory. When only an aggregate is available, show the filings it claims to summarise next to it — if the aggregate cannot name them, it cannot support a conviction call.
 
-- **SEC Form 4 Tracker**: Real-time Form 4 monitoring
-- **Finviz Insider**: Basic insider data with visualizations
-- **GuruFocus Insider**: Premium insider analysis
-
-**Premium Tools**
-- **Bloomberg Terminal**: Comprehensive insider data and analytics
-- **FactSet**: Insider transaction database
-- **S&P Capital IQ**: Detailed ownership and transaction data
-
-**Key Data Points to Extract**
+**Fields the analysis needs**
 - Insider name and title
 - Transaction date and filing date
 - Shares bought/sold
@@ -93,7 +78,7 @@ Reference the following sources for insider trading data:
 ```
 User: /insider-trading AAPL
 
-Claude retrieves recent Form 4 data from SEC EDGAR and analyzes
+The agent requests recent Form 4 data through the host data contract and analyzes it
 ```
 
 ### Format 2: Specific Time Period
@@ -107,7 +92,7 @@ Claude focuses on Q4 2024 insider transactions
 ```
 User: /insider-trading --data
 
-[Paste Form 4 data table or CSV from OpenInsider/SEC]
+[Paste the Form 4 data table or export you have]
 
 Claude analyzes provided data
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md

@@ -71,7 +71,7 @@ with the filing dates that support each.
 
 - Combine with /stock-eval for complete due diligence
 - Use /institutional-ownership for full insider + institutional picture
-- Feed analysis to /report-generator for visual charts of insider activity
+- Leave chart-ready tables in the answer; the host chart channel renders them (this plugin has no report export)
 - Best used monthly or after significant insider filing activity
 - Particularly valuable when analyzing small-mid cap stocks (insiders have more edge)
 

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md

@@ -5,6 +5,13 @@ description: Track changes in institutional holdings and identify smart money mo
 
 # Institutional Ownership Analysis
 
+## Evidence request
+
+通过宿主数据契约请求：披露文件（公告、年报或招股书，带回出处与文档日期）。
+
+缺哪个字段就点名并停止该字段下的分析；用户粘贴的材料标 `pasted by user`。
+
+
 ## ⚠️ Data Verification — Do This Before Any Analysis
 
 Before running any analysis, always retrieve the latest market data for the ticker:
@@ -22,12 +29,12 @@ Never substitute a remembered value for a retrieved one. Getting the number is t
 
 ## 📋 Data & Sources Header — Open Every Output With It
 
-The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
+The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard `result-validator` looks for first:
 
 ```
 Data & Sources
   As of:      <date the figures represent, e.g. 2026-06-30>
-  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
+  Source:     <venue, document, date — as returned by retrieval>
   Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
   Confidence: <HIGH | MEDIUM | LOW>
 ```

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md

@@ -129,7 +129,7 @@ Reference the following sources for institutional ownership data:
 - **What**: Quarterly holdings reports required of institutional investment managers exercising investment discretion over **≥ $100 million in Section 13(f) securities** (the test is 13(f) securities under management, not the firm's total AUM)
 - **Who**: Institutional investment managers
 - **When**: Filed within 45 days of quarter-end
-- **Where**: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=13F
+- **Where**: the manager's own filing, as returned by the host retrieval channel
 
 **13F Filing Calendar**
 - Q1 (Mar 31) → Filed by May 15
@@ -152,15 +152,12 @@ Reference the following sources for institutional ownership data:
 
 - **13G**: Passive investors, no control intent
   - Deadlines depend on filer type (revised schedule in force since 2024-09-30): qualified institutional investors — 45 days after the quarter-end in which they cross 5%, or 5 business days after month-end once above 10%; passive investors — 5 business days after crossing 5%; exempt investors — 45 days after quarter-end
-  - Verify the current deadline on sec.gov before dating a filing as late
+  - Check the deadline in force on the filing date before dating a filing as late; deadlines have changed twice since 2024
   - Simplified reporting for passive positions
 
-**Aggregator Services**
-- **WhaleWisdom.com**: Free 13F database with analytics
-- **Dataroma**: Tracks super investor portfolios
-- **GuruFocus**: Premium institutional tracking
-- **Whalewisdom**: Advanced screening and alerts
-- **Bloomberg/FactSet**: Comprehensive institutional data (paid)
+**What to request, and what it can support**
+
+Ask by manager and by issuer: the 13F-HR information table for a given quarter-end, the 13D/G filing with its amendment history, and the issuer's own share count for the same date. An aggregated "institutional ownership %" is a secondary figure — it mixes managers, quarter-ends and filing lags — so label it as such and never let it stand in for a manager-level position.
 
 
 This section is not finished here: `Analysis Framework` continues in `references/12-red-flags-warning-signs.md`.

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md

@@ -47,7 +47,7 @@ Claude focuses on specific institutional holders' activity
 ```
 User: /institutional-ownership --data
 
-[Paste 13F data table from WhaleWisdom or SEC]
+[Paste the 13F data table or export you have]
 
 Claude analyzes provided institutional holdings data
 ```
@@ -179,7 +179,7 @@ and ranks them by net institutional accumulation.
 
 - Combine with /insider-trading for complete ownership analysis
 - Use with /stock-eval for comprehensive due diligence
-- Feed to /report-generator for visual ownership trend charts
+- Leave chart-ready tables in the answer; the host chart channel renders them (this plugin has no report export)
 - Best used quarterly after 13F filing deadlines (May, Aug, Nov, Feb)
 - Particularly valuable for small-mid cap stocks where institutional buying can be catalyst
 - Less meaningful for mega-caps where ownership changes are primarily index-driven