@v587d/capital-generation 2.6.5 → 2.7.1

package/selected-skills/InvestSkill/README.md

@@ -0,0 +1,311 @@
+<div align="center">
+
+# InvestSkill
+
+**Professional investment analysis frameworks for US stocks — works on every AI platform**
+
+**No API keys · No subscriptions · 100% free**
+
+[![Cost: $0](https://img.shields.io/badge/cost-%240%20%C2%B7%20no%20API%20keys-22c55e?style=flat-square)](#no-api-keys-no-cost)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/yennanliu/InvestSkill?style=flat-square&color=gold)](https://github.com/yennanliu/InvestSkill/stargazers)
+[![Release](https://img.shields.io/github/v/release/yennanliu/InvestSkill?style=flat-square&color=22c55e)](https://github.com/yennanliu/InvestSkill/releases)
+[![Tests](https://img.shields.io/github/actions/workflow/status/yennanliu/InvestSkill/test.yml?style=flat-square&label=tests)](https://github.com/yennanliu/InvestSkill/actions)
+
+[Documentation](https://yennanliu.github.io/InvestSkill/) · [Learn Investing](https://yennanliu.github.io/InvestSkill/learning.html) · [Cookbook](https://yennanliu.github.io/InvestSkill/cookbook.html) · [繁體中文](README-zh-TW.md)
+
+</div>
+
+---
+
+## What is InvestSkill?
+
+InvestSkill is a collection of **30 structured analysis frameworks** that turn any AI assistant into an institutional-quality investment analyst. There is no runtime — every skill is a prompt that works in Claude Code, Cursor, Gemini CLI, GitHub Copilot, ChatGPT, or any other LLM.
+
+**Nothing to sign up for, nothing to pay for.** No API key, no data-vendor subscription, no billing setup — you bring the AI assistant you already use (a free tier or a local model works too) and InvestSkill is just markdown. See [No API keys, no cost](#no-api-keys-no-cost).
+
+```
+Ask your AI:  "Evaluate AAPL using the stock-eval framework"
+Get back:     Piotroski score · ROIC · moat rating · buy/hold/sell signal
+```
+
+<div class="home-card">
+  <span class="home-card-icon">🎓</span>
+  <div class="home-card-body">
+    <div class="home-card-title">New to investing? Start with the Learning guide</div>
+    <p>A thirteen-lesson field guide, in plain English and Traditional Chinese: Part I teaches the concepts behind every skill — reading a balance sheet, valuing a business, holding a portfolio — and Part II the practical foundations: accounts and orders, an ETF core, taxes (including for non-US investors), earnings season, and the psychology that protects the plan. No finance degree required.</p>
+    <p><a class="home-card-cta" href="https://yennanliu.github.io/InvestSkill/learning.html">Start learning →</a></p>
+  </div>
+</div>
+
+---
+
+## Quick Start
+
+**One command, any AI agent** — [pick yours on the website](https://yennj12.js.org/InvestSkill/#install):
+
+```bash
+# Claude Code
+curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a claude
+
+# Swap the agent: cursor · copilot · gemini · codex · opencode · any
+curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a cursor
+```
+
+The installer copies every framework into `.investskill/prompts/` and wires up your agent's own entry point — nothing else runs on your machine:
+
+| `-a` | Agent | Wires up |
+|------|-------|----------|
+| `claude` | Claude Code | `.claude/skills/<skill>/SKILL.md` (slash commands) |
+| `cursor` | Cursor | `.cursor/rules/investskill.mdc` |
+| `copilot` | GitHub Copilot | `.github/copilot-instructions.md` |
+| `gemini` | Gemini CLI | `GEMINI.md` |
+| `codex` | Codex | `AGENTS.md` |
+| `opencode` | OpenCode | `AGENTS.md` |
+| `any` | ChatGPT, Claude.ai, Ollama, … | `.investskill/prompts/` only — paste and go |
+
+Add `-g` to install for your user instead of one project, `-d DIR` to target another directory, or `-h` for all options. Existing instruction files are appended to, never overwritten, and re-running is a no-op. Read it first if you'd rather not pipe to `bash`: [install.sh](install.sh).
+
+**Claude Code via the plugin marketplace** — full slash-command support:
+```bash
+claude
+/plugin marketplace add yennanliu/InvestSkill
+/plugin install us-stock-analysis
+/us-stock-analysis:stock-eval AAPL
+```
+
+**Or clone the repo** — every framework in `prompts/`, use it anywhere:
+```bash
+git clone https://github.com/yennanliu/InvestSkill.git
+cd InvestSkill
+
+# Cursor
+cursor .
+# → @prompts/stock-eval.md Evaluate Apple
+
+# Gemini CLI
+gemini
+# → @prompts/stock-eval.md Evaluate Apple
+
+# Any LLM — paste the prompt file directly
+cat prompts/stock-eval.md | pbcopy
+```
+
+> Full platform guides: [Claude Code](README-claude-code.md) · [Cursor](README-cursor.md) · [Gemini CLI](README-gemini.md) · [Ollama](README-ollama.md)
+
+---
+
+## No API Keys, No Cost
+
+InvestSkill is **completely free to use** — there is nothing to buy, register, or configure.
+
+| | |
+|---|---|
+| **API keys** | **None.** No OpenAI / Anthropic / Alpha Vantage / Polygon key. The plugin never calls an endpoint — there is no code to call one with. |
+| **Subscriptions** | **None.** No paid tier, no seats, no usage metering, no account. |
+| **Market-data fees** | **None.** No Bloomberg, no paid data feed. The AI reads public filings and free sources — or you paste the numbers in yourself. |
+| **Install / runtime** | **None.** Every skill is a plain markdown prompt. Nothing runs on your machine, so nothing phones home. |
+| **License** | **MIT.** Free to use, fork, and modify — for personal or commercial work. |
+
+**The only thing you need is an AI assistant you already have.** That can be a paid plan (Claude Code, Cursor, Copilot), a free tier (ChatGPT, Gemini, Claude.ai), or a fully offline local model via [Ollama](README-ollama.md) — in which case the total cost of running every framework is literally zero.
+
+> Because there's no API, there's also no telemetry: InvestSkill never sees your tickers, your holdings, or your analysis. See [Data & Accuracy](site/content/DATA-AND-ACCURACY.md) for where the numbers actually come from.
+
+**Bring your own data.** The filing skills (`10k-digest`, `financial-report-analyst`, `fact-check`) carry a keyless SEC EDGAR recipe a tool-enabled assistant can follow by itself. If yours can't browse, two optional zero-dependency scripts fetch the primary source for you to paste — `node scripts/fetch-edgar.js AAPL --form 10-K` saves the filing as text, `node scripts/fetch-fundamentals.js AAPL` builds a reconciled statement pack from the SEC's XBRL facts. Neither is part of the plugin. Details on the [Data & Accuracy](site/content/DATA-AND-ACCURACY.md#bring-your-own-data-the-keyless-edgar-path) page.
+
+---
+
+## The 30 Frameworks
+
+### Core Stock Analysis
+
+| Skill | What it produces |
+|-------|-----------------|
+| `stock-eval` | Piotroski F-Score, ROIC, quality rating, go/no-go signal |
+| `technical-analysis` | MA chart (30/60/90/200/365d) with trade entry/target/stop, chart patterns, RSI/MACD, MTF alignment, Ichimoku |
+| `stock-valuation` | P/E · P/S · EV/EBITDA · comparable company multiples |
+| `economics-analysis` | Macro indicators, recession probability, rate sensitivity |
+
+### Financial Reports
+
+| Skill | What it produces |
+|-------|-----------------|
+| `financial-report-analyst` | 10-K / 10-Q key findings, red flags, accounting quality |
+| `10k-digest` | Structured markdown digest — abstract, section summaries, metrics table, refs (EN / 繁中) |
+| `earnings-call-analysis` | Management tone, guidance delta, hidden risks |
+
+### Market Monitoring
+
+| Skill | What it produces |
+|-------|-----------------|
+| `insider-trading` | SEC Form 4 patterns, net buy/sell sentiment |
+| `institutional-ownership` | 13F holdings changes, smart money flows |
+| `dividend-analysis` | Payout safety score, yield trap detection |
+| `short-interest` | Short ratio, days-to-cover, squeeze probability |
+
+### Advanced Research
+
+| Skill | What it produces |
+|-------|-----------------|
+| `competitor-analysis` | Moat score, Porter's Five Forces, market share |
+| `industry-map` | Supply/value-chain graph (upstream→downstream), chokepoints, margin-pool migration, second-order ideas |
+| `options-analysis` | Greeks, IV rank, earnings play strategy selection |
+| `portfolio-review` | Allocation health, concentration risk scoring, correlation analysis, tax-loss harvesting, rebalancing plan |
+| `sector-analysis` | Sector rotation signals, valuation tables, seasonality calendar, momentum scoring |
+| `stock-screener` | Multi-ticker ranking across valuation, quality, momentum, sentiment, and growth; leaderboard + top picks + avoid list |
+| `catalyst-calendar` | Forward-looking 90-day event calendar: earnings, macro events, catalysts, impact scoring, event-driven strategies |
+| `bear-case` | Deliberate short-seller red-team: bear thesis, accounting red flags, downside target, thesis-killers (counterevidence for any bull thesis) |
+| `position-ladder` | Staged entry ladder + trim/re-add cycle for a single holding: share-count floor/ceiling, blended cost basis, wash-sale flags, total-return-vs-buy-and-hold check, thesis-break gate |
+| `thesis-tracker` | Write, save, and re-check an investment thesis — KPIs with thresholds, invalidation triggers, catalysts, a pre-mortem, and a decision log; `--update` re-reads the saved file against new data and returns INTACT / WEAKENED / BROKEN |
+| `etf-analysis` | ETF / index-fund due diligence — expense ratio vs. category, tracking difference, liquidity, holdings concentration and tilt, overlap with your other positions, distribution and capital-gains history, structure warnings, and an ETF-vs-top-holdings comparison, scored as an ETF Fitness Score 0–10 |
+| `earnings-preview` | The before-earnings skill — consensus vs. whisper, 8-quarter beat rate and post-print move distribution, options-implied vs. realized move, what the current price already assumes, the KPIs to watch, and a three-scenario grid (beat-and-raise / beat-and-lower / miss) with expected reaction and a position rule for each |
+| `tax-lens` | US tax mechanics for a position or portfolio — short- vs. long-term treatment, wash-sale window check, qualified-dividend holding-period test, lot selection (specific-ID vs. FIFO), tax-loss-harvesting pairs, account placement, estimated annual tax drag — plus a --non-us module (W-8BEN, dividend withholding and treaty rates, capital-gains treatment, US estate-tax exposure, UCITS alternatives). Educational only, never tax advice |
+| `risk-stress-test` | Portfolio and position risk report — beta-weighted exposure, historical scenario replay (2008, March 2020, 2022 rate shock, 2025 tariff shock), parametric VaR / CVaR at 95 / 99 %, max-drawdown estimate, correlation-spike scenario, rate / USD / oil sensitivity, liquidity (days to exit at 20 % of ADV), and a Risk Budget Score 0–10 |
+
+### Meta & Output
+
+| Skill | What it produces |
+|-------|-----------------|
+| `full-report` | Runs all 15 modules and saves a standalone HTML report |
+| `report-generator` | Converts any analysis into a professional HTML/PDF report |
+| `chart-master` | Mermaid · ASCII · Chart.js visualizations from financial data |
+| `result-validator` | Scores any analysis on data quality, methodology, and signal consistency |
+| `learning-coach` | Explains any InvestSkill output like a mentor — every metric in plain words, why it matters, its good / bad range, and the lesson that teaches it — then asks 3–5 Socratic questions and "what would change your mind?". --level beginner / intermediate, --lang zh-TW, and a --quiz mode that drills a Learning lesson |
+| `fact-check` | 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 |
+
+### Aliases (redirects)
+
+Three earlier skills were absorbed into larger ones. They are still installed so old references keep working, but they are aliases, not frameworks, and are not counted above.
+
+| Alias | Redirects to |
+|-------|--------------|
+| `fundamental-analysis` | `stock-eval` (statement-level deep dive is a section of it) |
+| `dcf-valuation` | `stock-valuation` (DCF is Method 1 of its multi-method model) |
+| `research-bundle` | `full-report` (use `--depth quick / standard / comprehensive`) |
+
+---
+
+## Example Workflows
+
+**5-minute stock screen**
+```
+/stock-eval NVDA
+/stock-eval AMD
+→ Piotroski scores + quality rating for quick go/no-go
+```
+
+**Complete due diligence**
+```
+/stock-eval AAPL
+/stock-valuation AAPL --methods all
+/competitor-analysis AAPL
+/financial-report-analyst AAPL 10-K
+→ Full investment thesis in one session
+```
+
+**Earnings season playbook**
+```
+/stock-eval TICKER                    ← pre-earnings baseline
+/earnings-call-analysis TICKER        ← post-earnings [paste transcript]
+/options-analysis TICKER --earnings   ← vol expectations + strategy
+→ Complete earnings thesis
+```
+
+**Export a professional report**
+```
+/full-report AAPL
+→ Saves output/AAPL_report_2026-05-12.html
+   (hero header · metric cards · interactive Chart.js · signal block)
+```
+
+---
+
+## Output Format
+
+Every skill ends with a standardized **Investment Signal Block**:
+
+```
+╔══════════════════════════════════════════════╗
+║              INVESTMENT SIGNAL               ║
+╠══════════════════════════════════════════════╣
+║ Signal:      BULLISH / NEUTRAL / BEARISH     ║
+║ Confidence:  HIGH / MEDIUM / LOW             ║
+║ Horizon:     SHORT / MEDIUM / LONG-TERM      ║
+║ Score:       X.X / 10                        ║
+╠══════════════════════════════════════════════╣
+║ Action:      BUY / HOLD / SELL               ║
+║ Conviction:  STRONG / MODERATE / WEAK        ║
+╚══════════════════════════════════════════════╝
+```
+
+HTML reports render this as a styled dark panel with a score progress bar, ghost watermark text, and a teal/sky gradient accent — see [report-generator](prompts/report-generator.md) for the full design system.
+
+---
+
+## Platform Support
+
+| Platform | Setup | How it works |
+|----------|-------|-------------|
+| **Claude Code** | Marketplace install | 34 native slash commands (30 frameworks + 3 aliases + 1 output tool) |
+| **Cursor IDE** | Clone repo, open folder | Auto-loads `.cursor/rules/` |
+| **Gemini CLI** | Clone repo, `cd` into it | Auto-loads `GEMINI.md` |
+| **GitHub Copilot** | Clone repo, open in VS Code | Auto-loads `.github/copilot-instructions.md` |
+| **Ollama (local models)** | Clone repo, run a local model | Offline open-source models, no API key — [guide](README-ollama.md) |
+| **ChatGPT / Claude.ai** | Paste any `prompts/*.md` file | Works in any chat interface |
+| **Any other LLM** | Reference or paste prompt files | Platform-agnostic markdown |
+
+---
+
+## Learn the Frameworks
+
+New to investing, or unsure which skill to reach for? Start here:
+
+| Guide | What it gives you |
+|-------|-------------------|
+| [Concepts](site/content/CONCEPTS.md) | The mental models behind the metrics — quality vs. value vs. growth, intrinsic value, moats, risk, and the signal block |
+| [Glossary](site/content/GLOSSARY.md) | Plain-English definitions, formulas, and good/bad ranges for every metric the skills emit |
+| [Choose a Skill](site/content/CHOOSE-A-SKILL.md) | Map your goal to the right framework, plus comparisons of the ones that overlap |
+| [Use Cases](site/content/USE-CASES.md) | End-to-end journeys by investor type — income, first-timer, earnings, macro, skeptic |
+| [Data & Accuracy](site/content/DATA-AND-ACCURACY.md) | Where the numbers come from, how to spot hallucinations, and how to validate output |
+
+---
+
+## Documentation
+
+| Resource | Description |
+|----------|-------------|
+| [Live Docs Site](https://yennanliu.github.io/InvestSkill/) | Full documentation with dark-theme UI |
+| [Cookbook](https://yennanliu.github.io/InvestSkill/cookbook.html) | Walkthrough examples and use cases |
+| [Skill Reference](https://yennanliu.github.io/InvestSkill/skills.html) | All 30 frameworks, one browsable page each |
+| [Claude Code Guide](README-claude-code.md) | Plugin install + all slash commands |
+| [Cursor Guide](README-cursor.md) | Auto-loading rules + `@prompts/` usage |
+| [Gemini CLI Guide](README-gemini.md) | File references + multi-framework chains |
+| [Ollama Guide](README-ollama.md) | Local open-source models, offline & no API key |
+| [Adding Skills](ADDING-NEW-SKILLS.md) | 12-step contributor walkthrough |
+| [FAQ](FAQ.md) | 50+ answers covering all platforms |
+| [Changelog](CHANGELOG.md) | Version history |
+
+---
+
+## Contributing
+
+See [ADDING-NEW-SKILLS.md](ADDING-NEW-SKILLS.md) for the full process. The short version:
+
+1. `node scripts/new-skill.js <name> --category <core|reports|monitoring|advanced|meta> --title "…" --desc "…"` — scaffolds `SKILL.md` with the full output contract and wires the skill into the site, READMEs, cross-AI configs, and CHANGELOG
+2. Write the analysis in `plugins/us-stock-analysis/skills/<name>/SKILL.md`, then `node scripts/sync-prompts.js <name>` — `prompts/<name>.md` is generated from it (skills are auto-discovered; no `plugin.json` change)
+3. Run `npm test` — structure, prompt sync, skill contract, counts, and install script must all pass
+
+[Open an issue](https://github.com/yennanliu/InvestSkill/issues) to report bugs · [Start a discussion](https://github.com/yennanliu/InvestSkill/discussions) to propose features.
+
+---
+
+**Version:** 1.12.0 · **Frameworks:** 30 analysis frameworks (+ 3 aliases, 1 output tool) · **Skills:** 34 · **Platforms:** 7 · **License:** MIT · **Tests:** all passing
+
+---
+
+<div align="center">
+
+*For educational and research purposes only. Not financial advice.*  
+*Always consult a qualified financial advisor before making investment decisions.*
+
+</div>

package/selected-skills/InvestSkill/RELEASE-QUICK-REFERENCE.md

@@ -0,0 +1,230 @@
+# InvestSkill Release Quick Reference
+
+Fast-track guide for releasing new versions to all platforms.
+
+## 30-Second Release
+
+```bash
+# 1. Update version (two files)
+# .claude-plugin/marketplace.json → "version": "X.Y.Z"
+# plugins/us-stock-analysis/.claude-plugin/plugin.json → "version": "X.Y.Z"
+
+# 2. Update CHANGELOG.md
+# Add section: ## [X.Y.Z] - YYYY-MM-DD
+
+# 3. Commit
+git add .claude-plugin/marketplace.json plugins/us-stock-analysis/.claude-plugin/plugin.json CHANGELOG.md
+git commit -m "chore: bump version to X.Y.Z"
+git push origin main
+
+# ✅ Done! Auto-deploy handles everything else
+```
+
+## What Gets Released
+
+| Platform | Method | Status |
+|----------|--------|--------|
+| Claude Code | GitHub Release | ✅ Auto-published |
+| Cursor | Rules packaging | ✅ Auto-published |
+| Gemini CLI | Prompts packaging | ✅ Auto-published |
+| Copilot | Repository (.github/) | ✅ Auto-published |
+| Universal | GitHub artifacts | ✅ Auto-published |
+
+## Release Steps Checklist
+
+### Before Release
+- [ ] All features implemented and tested
+- [ ] CHANGELOG.md written with details
+- [ ] README.md updated if needed
+- [ ] Documentation (GEMINI.md, etc.) updated
+- [ ] Tests passing: `npm test`
+- [ ] No uncommitted changes: `git status`
+
+### During Release
+- [ ] Update `marketplace.json` version
+- [ ] Update `plugin.json` version  
+- [ ] Update `CHANGELOG.md`
+- [ ] Commit changes
+- [ ] Push to main branch
+
+### After Release (Automatic)
+- [ ] ✅ Tests run automatically
+- [ ] ✅ Version change detected
+- [ ] ✅ Release artifacts created
+- [ ] ✅ Published to all 5 platforms
+- [ ] ✅ DEPLOYMENTS.md updated
+- [ ] ✅ Release notes generated
+
+## Verify Release
+
+**Check GitHub Actions**:
+1. Visit: https://github.com/yennanliu/InvestSkill/actions
+2. Click latest "Auto Deploy" workflow
+3. Wait for all jobs to complete (green checkmarks)
+
+**Check Release**:
+1. Visit: https://github.com/yennanliu/InvestSkill/releases
+2. Latest release should be: `InvestSkill vX.Y.Z`
+3. Artifacts should include:
+   - `invest-skill-marketplace-X.Y.Z.tar.gz`
+   - `us-stock-analysis-X.Y.Z.tar.gz`
+   - `cursor-rules-X.Y.Z.mdc`
+   - `gemini-prompts-X.Y.Z.tar.gz`
+   - Platform release notes
+
+**Check Deployment Record**:
+1. Visit: [DEPLOYMENTS.md](DEPLOYMENTS.md)
+2. Latest entry should be v**X.Y.Z**
+3. All platforms should show ✅
+
+## Common Version Numbers
+
+- **X.Y.0** — Major version (new skills, breaking changes)
+- **X.0.Z** — Minor version (new features)
+- **0.0.Z** — Patch version (bug fixes, documentation)
+
+Examples:
+- `1.3.0` — Minor release (new documentation, multi-platform support)
+- `1.2.1` — Patch release (bug fix)
+- `2.0.0` — Major release (major new features or breaking changes)
+
+## Semantic Versioning
+
+Follow [Semantic Versioning](https://semver.org/):
+
+- **Major** (1.0.0 → 2.0.0): Breaking changes
+  - Removing skills
+  - Changing output format significantly
+  - Major architecture changes
+
+- **Minor** (1.0.0 → 1.1.0): New features
+  - Adding new skills
+  - New analysis frameworks
+  - New platform support
+
+- **Patch** (1.0.0 → 1.0.1): Bug fixes
+  - Documentation fixes
+  - Small improvements
+  - Performance improvements
+
+## Version Consistency Check
+
+Before pushing:
+
+```bash
+# Verify versions match
+jq '.metadata.version' .claude-plugin/marketplace.json
+jq '.version' plugins/us-stock-analysis/.claude-plugin/plugin.json
+
+# They must be identical!
+```
+
+## Rollback (If Needed)
+
+```bash
+# Delete the last tag
+git tag -d vX.Y.Z
+git push origin :refs/tags/vX.Y.Z
+
+# Revert version bumps
+git revert HEAD
+
+# Or reset to previous commit
+git reset --hard HEAD~1
+git push origin main
+```
+
+## Release Notification
+
+After release completes, notify:
+
+1. **GitHub Issues** — Link to release in pinned issue
+2. **GitHub Discussions** — Post release announcement
+3. **Social Media** — Tweet/share the release
+
+Template:
+```
+🚀 InvestSkill vX.Y.Z released!
+
+✨ What's new:
+- Feature 1
+- Feature 2
+- Bug fix 1
+
+📦 Available on:
+✅ Claude Code
+✅ Cursor
+✅ Gemini CLI
+✅ GitHub Copilot
+✅ Universal prompts
+
+📖 See release notes: [link]
+```
+
+## Troubleshooting
+
+**Q: Version not detected?**
+```bash
+# Verify version consistency
+jq '.metadata.version' .claude-plugin/marketplace.json
+jq '.version' plugins/us-stock-analysis/.claude-plugin/plugin.json
+```
+
+**Q: Tests failing?**
+```bash
+# Run locally
+npm test
+node scripts/test-skills.js
+```
+
+**Q: Artifacts not created?**
+```bash
+# Check GitHub Actions logs:
+# https://github.com/yennanliu/InvestSkill/actions
+```
+
+**Q: Deployment record missing?**
+```bash
+# Manual update:
+node scripts/record-deploy.js
+```
+
+## Script Reference
+
+| Script | Purpose | Usage |
+|--------|---------|-------|
+| `scripts/test-skills.js` | Unit tests | `node scripts/test-skills.js` |
+| `scripts/publish-cursor-rules.js` | Cursor publishing | Auto (in CI) |
+| `scripts/publish-gemini.js` | Gemini publishing | Auto (in CI) |
+| `scripts/generate-platform-release-notes.js` | Release notes | Auto (in CI) |
+| `scripts/record-deploy.js` | Deployment record | Auto (in CI) |
+
+## Advanced: Enable Registry Publishing
+
+To publish directly to platform registries:
+
+```bash
+# Add GitHub Secrets:
+CURSOR_REGISTRY_TOKEN=<token>
+GEMINI_REGISTRY_TOKEN=<token>
+GEMINI_REGISTRY_URL=<url>
+
+# Then releases publish to registries automatically
+```
+
+See [CI-CD-GUIDE.md](CI-CD-GUIDE.md) for details.
+
+## Need Help?
+
+1. **Read** [CI-CD-GUIDE.md](CI-CD-GUIDE.md) for complete documentation
+2. **Check** GitHub Actions logs
+3. **Review** workflow files in `.github/workflows/`
+4. **Open** an issue on GitHub
+
+---
+
+**Quick Links**:
+- 📖 [Full CI/CD Guide](CI-CD-GUIDE.md)
+- 🚀 [Releases Page](https://github.com/yennanliu/InvestSkill/releases)
+- 📊 [Deployment History](DEPLOYMENTS.md)
+- ⚙️ [GitHub Actions](https://github.com/yennanliu/InvestSkill/actions)

package/selected-skills/InvestSkill/RELEASE_NOTES.md

@@ -0,0 +1,121 @@
+## InvestSkill v1.12.0
+
+**30 Professional Investment Analysis Frameworks** · 34 skills · 7 platforms · no API keys, no runtime, no telemetry
+
+Released 2026-09-25. The largest release since 1.0: six new frameworks plus the `fact-check` meta framework, an enforced output contract on every skill, Learning track Part II, a redesigned docs site, a one-command installer for any AI agent, and a keyless SEC EDGAR data path for users whose assistant cannot browse.
+
+## What's New
+
+**🧭 Six new analysis frameworks + `fact-check`** (advertised count 26 → **30**, with `fundamental-analysis` / `dcf-valuation` / `research-bundle` now counted as aliases):
+- `thesis-tracker` — write, save, and re-check an investment thesis; `--update` returns **INTACT / WEAKENED / BROKEN**
+- `etf-analysis` — ETF / index-fund due diligence with an ETF Fitness Score 0–10
+- `earnings-preview` — the *before*-earnings skill: consensus vs. whisper, implied vs. realized move, three-scenario grid with position rules
+- `tax-lens` — holding periods, wash sales, lot selection, harvesting, account placement; `--non-us` module (W-8BEN, withholding, estate tax, UCITS). Educational only
+- `risk-stress-test` — beta-weighted exposure, scenario replay (2008 · 2020 · 2022 · 2025), VaR / CVaR, liquidity; Risk Budget Score 0–10
+- `learning-coach` — explains any InvestSkill output like a mentor; `--quiz <lesson>` drills a Learning lesson
+- `fact-check` — claim-level verification against primary sources, recomputation, and a corrected report with inline citations; Verification Score 0–10 feeds `result-validator`
+
+**📋 Output contract enforced on every analysis skill** — the `Data & Sources` header (As of · Source · Retrieval · Confidence), the Data Verification gate, and a Thesis Invalidation section are now present in all 30 frameworks and checked by `scripts/check-skill-contract.js` in `npm test`.
+
+**🔎 Bring your own data — the keyless SEC EDGAR path**
+- `10k-digest`, `financial-report-analyst`, and `fact-check` carry a retrieval recipe a tool-enabled assistant can follow on its own: ticker → CIK → `data.sec.gov` submissions index → filing document → XBRL company facts, with the SEC's User-Agent and rate rules
+- Two optional, zero-dependency helpers for assistants that cannot browse: `node scripts/fetch-edgar.js AAPL --form 10-K` saves a filing as pasteable text; `node scripts/fetch-fundamentals.js AAPL` builds a reconciled statement pack from the XBRL facts. Outside the plugin; covered by a 194-check offline suite in CI
+- New **Bring Your Own Data** section on the Data & Accuracy page (EN + 繁體中文)
+
+**⚡ One-command install for any AI agent**
+```bash
+curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a claude   # or cursor · copilot · gemini · codex · opencode · any
+```
+Existing instruction files are appended to, never overwritten; re-running is a no-op. 116 install checks run in CI, including live sandboxed installs.
+
+**🎓 Learning track Part II** — Lessons 9–13 (Before Your First Trade · ETFs & Index Investing · Taxes & Account Types incl. a non-US section · Earnings Season · Psychology & Process), a "When the Answer Is No" case study, self-check quizzes, and a glossary grown to 76 terms.
+
+**🎨 Site redesign** — real landing pages (EN + zh-TW) with an animated terminal demo, a filterable Skill Reference grid, per-skill run boxes, dark mode, keyboard search, and an install picker. New META 10-K deep-dive demo and seven live Cookbook workflow runs.
+
+**🛠️ Tooling** — `scripts/sync-prompts.js` (prompts are now generated from `SKILL.md`), `scripts/new-skill.js` scaffolder, `scripts/eval-skills.js` opt-in behavioural eval, shared `signal-block.js` / `skill-registry.js` libraries, and a roadmap with progress tracking.
+
+## Quick Start
+
+### Claude Code
+```bash
+/plugin marketplace add yennanliu/InvestSkill
+/plugin install us-stock-analysis
+/us-stock-analysis:stock-eval AAPL
+```
+
+### Any agent via the installer
+```bash
+curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a cursor
+```
+
+### Cursor
+Rules auto-load in Cursor AI Chat (Cmd+K):
+```
+@prompts/stock-eval.md Evaluate Apple (AAPL)
+```
+
+### Gemini CLI
+In project directory:
+```bash
+gemini
+> @prompts/stock-eval.md Evaluate Apple (AAPL)
+```
+
+## Platform Availability
+
+| Platform | Status | Installation | Documentation |
+|----------|--------|---------------|----------------|
+| Claude Code | ✅ Available | `/plugin install us-stock-analysis` or `install.sh -a claude` | [README-claude-code.md](README-claude-code.md) |
+| Cursor IDE | ✅ Available | Auto-loads from `.cursor/rules/invest-skill.mdc` or `install.sh -a cursor` | [README-cursor.md](README-cursor.md) |
+| Gemini CLI | ✅ Available | Auto-loads from `GEMINI.md` or `install.sh -a gemini` | [README-gemini.md](README-gemini.md) |
+| GitHub Copilot | ✅ Available | Auto-loads from `.github/copilot-instructions.md` or `install.sh -a copilot` | [README.md](README.md) |
+| Codex / OpenCode | ✅ Available | `install.sh -a codex` / `-a opencode` (writes `AGENTS.md`) | [README.md](README.md) |
+| Universal (ChatGPT, Claude.ai, Ollama, …) | ✅ Available | `install.sh -a any` or copy prompts from `prompts/` | [README-ollama.md](README-ollama.md) |
+
+## Download & Verify
+
+All releases include checksums for verification:
+
+```bash
+# Download artifacts
+tar xzf invest-skill-marketplace-1.12.0.tar.gz
+
+# Verify checksums
+sha256sum -c checksums.txt
+```
+
+**Artifacts:**
+- `invest-skill-marketplace-1.12.0.tar.gz` — Full marketplace (all platforms)
+- `us-stock-analysis-1.12.0.tar.gz` — Claude Code plugin only
+- `checksums.txt` — SHA-256 verification file
+
+## Full Changelog
+
+See [CHANGELOG.md → 1.12.0](CHANGELOG.md#1120---2026-09-25) for every entry, including the review-driven fixes to the EDGAR helpers (filename collisions for same-day filings, `LongTermDebt` double counting, `--limit` validation, 13F-HR routed by manager rather than issuer).
+
+**Upgrade notes**
+- No breaking changes. Skill names, the signal block, and the plugin layout are unchanged.
+- `fundamental-analysis`, `dcf-valuation`, and `research-bundle` still work but are aliases; prefer `stock-eval`, `stock-valuation`, and `full-report`.
+- The EDGAR helpers need Node ≥ 18 and, per SEC fair-access rules, `EDGAR_USER_AGENT="Your Name your@email"`.
+- Two stale, unreferenced 10-K PDFs were removed from `data/`; `fetch-edgar.js` reproduces either as text on demand.
+
+---
+
+## Documentation & Resources
+
+- 📖 [Complete README](README.md) — All platforms setup guide
+- 🌐 [Documentation site](https://yennanliu.github.io/InvestSkill/) — Skill Reference, Learning track, Cookbook, Data & Accuracy
+- 📊 [Platform Compatibility](PLATFORM-COMPATIBILITY.md) — Feature comparison
+- 📚 [Cookbook](site/content/COOKBOOK.md) — Examples and walkthroughs
+- 🔧 [CI/CD Guide](CI-CD-GUIDE.md) — Automated release pipeline
+- 💡 [30 Investment Frameworks](prompts/) — Universal prompt files
+
+## Support
+
+- 🐛 [Report Issues](https://github.com/yennanliu/InvestSkill/issues)
+- 💬 [Discussions](https://github.com/yennanliu/InvestSkill/discussions)
+- 📧 Feedback: [GitHub Issues](https://github.com/yennanliu/InvestSkill/issues/new)
+
+---
+
+**Legal:** This toolkit provides educational analysis only and does NOT constitute financial advice. Always consult qualified financial advisors and do your own research.